update readmes

AccelerometerPlay/README.md

@@ -12,3 +12,16 @@ urlFragment: accelerometerplay
 
 This sample demonstrates usage of the accelerometer to animate
 balls rolling on a wooden table.
+
+![Screenshot of game with balls rolling on wooden surface](Screenshots/accelerometerplay.png)
+
+## Prerequisites
+
+- [Visual Studio](https://visualstudio.microsoft.com/) on Mac or Windows.
+  - _Mobile Development with .NET (Xamarin)_ workload installed.
+- Android SDK installed (Visual Studio installer will do this for you).
+
+## Running the sample
+
+1. Open the solution file (**.sln**) in Visual Studio.
+1. Use the **Run** button or menu to start the app.

AccessoryViews/README.md

@@ -8,6 +8,6 @@ products:
 - xamarin
 urlFragment: accessoryviews
 ---
-# AccessoryViews
+# Xamarin.Android AccessoryViews
 
-This sample is part of the Android ListViews and Adapters series. 
+This sample is part of the Android ListViews and Adapters [documentation](https://docs.microsoft.com/xamarin/android/user-interface/layouts/list-view/).

ActionBarPullToRefresh/README.md

@@ -5,15 +5,18 @@ A binding library for https://github.com/chrisbanes/ActionBar-PullToRefresh.
 
 To get javadoc so that the binding dll can get method parameter names:
 
-	git clone above.
-	cd ActionBar-PullToRefresh
-	mvn clean verify javadoc:aggregate-jar
+```cmd
+git clone above.
+cd ActionBar-PullToRefresh
+mvn clean verify javadoc:aggregate-jar
+```
 
 If you need to update library project zip:
 
-	cd library
-	android update project -p .
-	ant debug
-	zip -r ActionBar-PullToRefresh.zip bin/classes.jar bin/AndroidManifest.xml res
-	mv ActionBar-PullToRefresh.zip ActionBarPullToRefresh/Jars
-
+```cmd
+cd library
+android update project -p .
+ant debug
+zip -r ActionBar-PullToRefresh.zip bin/classes.jar bin/AndroidManifest.xml res
+mv ActionBar-PullToRefresh.zip ActionBarPullToRefresh/Jars
+```

ActionBarViewPager/Readme.md

@@ -8,11 +8,7 @@ products:
 - xamarin
 urlFragment: actionbarviewpager
 ---
-# HelloSwipeViewWithTabs
-
-Author: Richard Lander -- rlander@microsoft.com
-
-License: Apache 2
+# Xamarin.Android HelloSwipeViewWithTabs
 
 This sample app demonstrates how to use ViewPager and ActionBar
 together. ViewPager provides a "swiping view" and ActionBar provides
@@ -22,6 +18,8 @@ These two classes provide a very nice user experience together, but do
 not provide an intuitive approach to integration. This sample
 demonstrates how.
 
+![Android app with tabs](Screenshots/01.png)
+
 There are two primary integration challenges:
 
 - ActionBar and Viewpager come in different versions of the Android SDK and require special handling to work together.
@@ -40,9 +38,13 @@ and related classes whereas Viewpager works with
 trick is to change your Activity to derive from
 [FragmentActivity](http://developer.android.com/reference/android/support/v4/app/FragmentActivity.html),
 which satisfies both the regular and 'Support' API worlds.
- 
+
 The sample provides "shape" classes that satisfy the API requirements
 of ViewPager, and then uses lambdas to provide the required
 implementation. This approach ends up being quite nice, since the
 implementation can be written inline within the Activity without
-hiding it within separate classes. That's not a requirement, however.
+hiding it within separate classes. That's not a requirement, however.
+
+## License
+
+Apache 2

ActivityLifecycle/README.md

@@ -1,17 +1,16 @@
 ---
 name: Xamarin.Android - Android Activity Lifecycle
-description: This sample app accompanies the article, Walkthrough - Saving the Activity State. ![](Screenshots/example-screenshot.png)
+description: This sample app accompanies Saving the Activity State documentation.
 page_type: sample
 languages:
 - csharp
 products:
 - xamarin
 urlFragment: activitylifecycle
 ---
-# Android Activity Lifecycle
+# Xamarin.Android activity lifecycle
 
-This sample app accompanies the article, 
-[Walkthrough - Saving the Activity State](http://developer.xamarin.com/guides/android/application_fundamentals/activity_lifecycle/saving_state_walkthrough).
+This sample app accompanies the article,
+[Walkthrough - Saving the Activity State](https://docs.microsoft.com/en-us/xamarin/android/app-fundamentals/activity-lifecycle/saving-state).
 
-
-[ ![](Screenshots/example-screenshot-sml.png)](Screenshots/example-screenshot.png)
+[![Two phones showing screen in portrait and landscape](Screenshots/example-screenshot-sml.png)](Screenshots/example-screenshot.png)

AdvancedAppLifecycleDemos/README.md

@@ -8,13 +8,11 @@ products:
 - xamarin
 urlFragment: advancedapplifecycledemos
 ---
-# ActivityLifecycle Demos
-Four sample projects that cover advanced activity and application lifecycle scenarios in 
-Android:
- * ActivityLifecycle - Handling the activity lifecycle including rotation and subscribing to external events
- * AppInitialization - Showing a loading screen while the app initializes
- * HandlingCrashes - Gracefully handling app crashes, waiting for app initializing and launching specific activities after crashes
- * InitializingAppAndServices - Handling multiple asynchronous initializations
+# Xamarin.Android ActivityLifecycle Demos
 
-## Authors
-Bryan Costanich
+Four sample projects that cover advanced activity and application lifecycle scenarios in Android:
+
+- ActivityLifecycle - Handling the activity lifecycle including rotation and subscribing to external events
+- AppInitialization - Showing a loading screen while the app initializes
+- HandlingCrashes - Gracefully handling app crashes, waiting for app initializing and launching specific activities after crashes
+- InitializingAppAndServices - Handling multiple asynchronous initializations

AdvancedImmersiveMode/README.md

@@ -1,19 +1,22 @@
 ---
 name: Xamarin.Android - Advanced Immersive Mode
-description: Android 4.4 introduces a way for you to provide a more immersive screen experience in your app, by letting users show or hide the status bar and...
+description: "Android 4.4 introduces a way for you to provide a more immersive screen experience in your app: show/hide the status bar #androidkitkat"
 page_type: sample
 languages:
 - csharp
 products:
 - xamarin
 urlFragment: advancedimmersivemode
 ---
-# Advanced Immersive Mode
-Android 4.4 introduces a way for you to provide a more immersive 
-screen experience in your app, by letting users show or hide 
+# Xamarin.Android Advanced Immersive Mode
+
+Android 4.4 introduces a way for you to provide a more immersive
+screen experience in your app, by letting users show or hide
 the status bar and navigation bar with a swipe.
 
-This sample demonstrates how this feature interacts with some 
-of the other UI flags related to full-screen apps. The sample 
-also shows how to implement a "sticky" mode, which re-hides 
-the bars a few seconds after the user swipes them back in.
+This sample demonstrates how this feature interacts with some
+of the other UI flags related to full-screen apps. The sample
+also shows how to implement a "sticky" mode, which re-hides
+the bars a few seconds after the user swipes them back in.
+
+![Android app without status bar](Screenshots/AdvancedImmersiveMode1.png)

android-support/ViewModel/README.md

@@ -1,27 +1,23 @@
 ---
 name: Xamarin.Android - ViewModel Sample
-description: This sample demonstrates usage of ViewModel and LifeCycle Architecture Components library by Android. Build Requirements Using this sample requires...
+description: "This sample demonstrates usage of ViewModel and LifeCycle Architecture Components library by Android #androidoreo"
 page_type: sample
 languages:
 - csharp
 products:
 - xamarin
 urlFragment: android-support-viewmodel
 ---
-# ViewModel Sample
+# Xamarin.Android ViewModel Sample
 
 This sample demonstrates usage of ViewModel and LifeCycle [Architecture Components](https://developer.android.com/topic/libraries/architecture/index.html) library by Android.
 
+![ViewModel Sample application screenshot](Screenshots/Home.png "ViewModel Sample application screenshot")
 
 ## Build Requirements
 
 Using this sample requires the Android 8.1 (API 27) and the Xamarin.Android 8.2 or higher.
 
+## License
 
-![ViewModel Sample application screenshot](Screenshots/Home.png "ViewModel Sample application screenshot")
-
-## Authors
-
-Copyright (c) 2018 The Android Open Source Project, Inc.
-
-Ported to Xamarin.Android by Gonzalo Martin
+Original copyright (c) 2018 The Android Open Source Project, Inc.

android5.0/ActivitySceneTransitionBasic/README.md

@@ -1,25 +1,28 @@
 ---
 name: Xamarin.Android - ActivitySceneTransitionBasic
-description: This sample demonstrates how to the use Activity scene transitions when transitioning from one activity to another. Uses a combination of moveImage...
+description: "Demonstrates how to the use Activity scene transitions when transitioning from one activity to another #androidlollipop"
 page_type: sample
 languages:
 - csharp
 products:
 - xamarin
 urlFragment: android50-activityscenetransitionbasic
 ---
-# ActivitySceneTransitionBasic
+# Xamarin.Android ActivitySceneTransitionBasic
+
 This sample demonstrates how to the use Activity scene transitions when transitioning from one activity to another. Uses a combination of moveImage and changeBounds to nicely transition from a grid of images to an activity with a large image and detail text.
 
 ## Instructions
+
 * Touch each photo to activate a transition to a details page for each one.
 * Hitting the back button will activate a transition back to the grid of photos.
 
 ## Build Requirements
+
 This sample requires Xamarin.Android 4.17 or later and an Android L or later device.
 
 ![ActivitySceneTransitionBasic application screenshot](Screenshots/Detailed View.png "ActivitySceneTransitionBasic application screenshot")
 
 ## Author
-Copyright (c) 2005-2008, The Android Open Source Project  
-Ported to Xamarin.Android by Sean Pearl
+
+Original copyright (c) 2005-2008, The Android Open Source Project  

android5.0/AppRestrictionSchema/README.md

@@ -1,6 +1,6 @@
 ---
 name: Xamarin.Android - App Restriction Schema
-description: This sample shows a basic demonstration of using a profile owner to set app restrictions in Android. This is to used alongside...
+description: "This sample shows a basic demonstration of using a profile owner to set app restrictions in Android #androidlollipop"
 page_type: sample
 languages:
 - csharp
@@ -12,19 +12,19 @@ urlFragment: android50-apprestrictionschema
 
 This sample shows a basic demonstration of using a profile owner to set app restrictions in Android. This is to used alongside AppRestrictionEnforcer, which serves as a profile owner for this.
 
+![App Restriction Schema application screenshot](Screenshots/Not Restricted.png "App Restriction Schema application screenshot")
+
 ## Instructions
 
-* Run the project
-* Pressing the button on this fragment pops up a simple Toast message. The button is enabled or disabled according to the restrictions set by device/profile owner. You can use the AppRestrictionEnforcer sample as a profile owner for this.
+- Run the project
+- Pressing the button on this fragment pops up a simple Toast message. The button is enabled or disabled according to the restrictions set by device/profile owner. You can use the AppRestrictionEnforcer sample as a profile owner for this.
 
 ## Build Requirements
-* Xamarin Studio 5.3+
-* Xamarin Android 4.20+
-* Android SDK (Lollipop)
 
-![App Restriction Schema application screenshot](Screenshots/Not Restricted.png "App Restriction Schema application screenshot")
+- Xamarin Studio 5.3+
+- Xamarin Android 4.20+
+- Android SDK (Lollipop)
 
-## Author 
-Copyright 2014 The Android Open Source Project
+## License
 
-Ported to Xamarin.Android by John Pilczak
+Original copyright 2014 The Android Open Source Project

android5.0/AppUsageStatistics/README.md

@@ -1,6 +1,6 @@
 ---
 name: Xamarin.Android - App Usage Statistics Sample
-description: This sample shows how to use the App usage statistics API to let users collect statistics related to usage of the applications. Introduction The...
+description: "Shows how to use the App usage statistics API to let users collect statistics related to usage of the applications #androidlollipop"
 page_type: sample
 languages:
 - csharp
@@ -13,6 +13,8 @@ urlFragment: android50-appusagestatistics
 This sample shows how to use the App usage statistics API to let users collect statistics related
 to usage of the applications.
 
+![App Usage Statistics Sample application screenshot](Screenshots/1-view-daily.png) ![Weekly view](Screenshots/2-view-weekly.png)
+
 ## Introduction
 
 The App usage statistics API allows app developers to collect statistics related to usage of
@@ -29,17 +31,11 @@ by the timestamp of the last time each app was used.
 * View basic usage statistics for apps on the device
 
 ## Build Requirements
-Using this sample requires the Android SDK platform for Android 5.0 (API level 21).
-
-## Screenshots
 
-<img src="Screenshots/1-view-daily.png" height="400" alt="Screenshot"/> <img src="Screenshots/2-view-weekly.png" height="400" alt="Screenshot"/>
+Using this sample requires the Android SDK platform for Android 5.0 (API level 21).
 
-![App Usage Statistics Sample application screenshot](Screenshots/1-view-daily.png "App Usage Statistics Sample application screenshot")
+## License
 
-## Authors
-Copyright (c) 2014 The Android Open Source Project, Inc.
+Original copyright (c) 2014 The Android Open Source Project, Inc.
 
 Ported from [Android AppUsageStatistics Sample](https://github.com/googlesamples/android-AppUsageStatistics)
-
-Ported to Xamarin.Android by Dylan Kelly

android5.0/Camera2Basic/Readme.md

@@ -1,30 +1,31 @@
 ---
 name: Xamarin.Android - Camera2 Basic Sample
-description: This sample demonstrates how to use the new Camera2 APIs to render a preview of a camera's viewport, capture an image and save it to the device's...
+description: "Demonstrates how to use the new Camera2 APIs to render a preview of a camera's viewport, capture an image and save it #androidlollipop"
 page_type: sample
 languages:
 - csharp
 products:
 - xamarin
 urlFragment: android50-camera2basic
 ---
-# Camera2 Basic Sample
+# Xamarin.Android Camera2 Basic Sample
 
 This sample demonstrates how to use the new Camera2 APIs to render a preview of a camera's viewport, capture an image and save it to the device's storage.
 
+![Camera2 Basic Sample application screenshot](Screenshots/Viewfinder.png "Camera2 Basic Sample application screenshot")
+
 ## Instructions
-* Touch the Picture button to take a photo that will automatically be saved on your device.
 
-* Touch the info button to find out a little bit more about the app.
+- Touch the Picture button to take a photo that will automatically be saved on your device.
+
+- Touch the info button to find out a little bit more about the app.
 
-* Requires a device with a rear facing camera
+- Requires a device with a rear facing camera
 
 ## Build Requirements
-Using this sample requires a device that is Android L or later and Xamarin.Android 4.17 or later.
 
-![Camera2 Basic Sample application screenshot](Screenshots/Viewfinder.png "Camera2 Basic Sample application screenshot")
+Using this sample requires a device that is Android L or later and Xamarin.Android 4.17 or later.
 
-## Author
-Copyright (c) 2005-2008, The Android Open Source Project  
-Ported to Xamarin.Android by Christopher Blackman
+## License
 
+Original copyright (c) 2005-2008, The Android Open Source Project  

android5.0/Camera2Raw/README.md

@@ -1,28 +1,31 @@
 ---
 name: Xamarin.Android - Camera2Raw Sample
-description: This sample demonstrates how to use the Camera2 APIs to capture RAW camera buffers and save them to the devices storage as a dng file. Instructions...
+description: "Demonstrates how to use the Camera2 APIs to capture RAW camera buffers and save them to the devices storage as a dng file #androidlollipop"
 page_type: sample
 languages:
 - csharp
 products:
 - xamarin
 urlFragment: android50-camera2raw
 ---
-# Camera2Raw Sample
+# Xamarin.Android Camera2Raw Sample
 
 This sample demonstrates how to use the Camera2 APIs to capture RAW camera buffers and save them to the devices storage as a dng file.
 
+![Camera2Raw Sample application screenshot](Screenshots/Camera2Raw0.png "Camera2Raw Sample application screenshot")
+
 ## Instructions
-* Touch the Picture button to take two photos that will automatically be saved on your device.
-* Touch the Info button to find out a little bit more about the app.
-* Requires a device with a rear facing camera
+
+- Touch the Picture button to take two photos that will automatically be saved on your device.
+- Touch the Info button to find out a little bit more about the app.
+- Requires a device with a rear facing camera
 
 ## Build Requirements
+
 Using this sample requires a device that is Android 5.0 or later and Xamarin.Android 5.0 or later.
 
-![Camera2Raw Sample application screenshot](Screenshots/Camera2Raw0.png "Camera2Raw Sample application screenshot")
+## License
+
+Original copyright (c) 2014 The Android Open Source Project, Inc.
 
-## Authors
-Copyright (c) 2014 The Android Open Source Project, Inc.
 Ported from [Android Camera2Raw Sample](https://github.com/googlesamples/android-Camera2Raw)
-Ported to Xamarin.Android by Aaron Sky