dotnet · conceptdev · Jul 18, 2019 · Jul 18, 2019 · Jul 18, 2019 · Jul 18, 2019
diff --git a/AccelerometerPlay/README.md b/AccelerometerPlay/README.md
@@ -1,5 +1,16 @@
-Accelerometer Play
-==================
+---
+name: Xamarin.Android - Accelerometer Play
+description: This sample demonstrates usage of the accelerometer to animate balls rolling on a wooden table.
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: accelerometerplay
+---
+# Accelerometer Play
 
 This sample demonstrates usage of the accelerometer to animate
 balls rolling on a wooden table.
diff --git a/AccessoryViews/README.md b/AccessoryViews/README.md
@@ -1,4 +1,15 @@
-AccessoryViews
-==============
+---
+name: Xamarin.Android - AccessoryViews
+description: This sample is part of the Android ListViews and Adapters series.
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: accessoryviews
+---
+# AccessoryViews
 
 This sample is part of the Android ListViews and Adapters series. 
diff --git a/ActionBarViewPager/Readme.md b/ActionBarViewPager/Readme.md
@@ -1,5 +1,16 @@
-HelloSwipeViewWithTabs
-======================
+---
+name: Xamarin.Android - HelloSwipeViewWithTabs
+description: 'Author: Richard Lander -- rlander@microsoft.com License: Apache 2 This sample app demonstrates how to use ViewPager and ActionBar together....'
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: actionbarviewpager
+---
+# HelloSwipeViewWithTabs
 
 Author: Richard Lander -- rlander@microsoft.com
 

diff --git a/ActivityLifecycle/README.md b/ActivityLifecycle/README.md
@@ -1,5 +1,16 @@
-Android Activity Lifecycle
-==========================
+---
+name: Xamarin.Android - Android Activity Lifecycle
+description: This sample app accompanies the article, Walkthrough - Saving the Activity State. ![](Screenshots/example-screenshot.png)
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: activitylifecycle
+---
+# 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).

diff --git a/AdvancedAppLifecycleDemos/README.md b/AdvancedAppLifecycleDemos/README.md
@@ -1,12 +1,22 @@
-ActivityLifecycle Demos
-=======================
+---
+name: Xamarin.Android - ActivityLifecycle Demos
+description: 'Four sample projects that cover advanced activity and application lifecycle scenarios in Android: ActivityLifecycle - Handling the activity...'
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+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
 
-Authors
--------
+## Authors
 Bryan Costanich
diff --git a/AdvancedImmersiveMode/README.md b/AdvancedImmersiveMode/README.md
@@ -1,5 +1,16 @@
-Advanced Immersive Mode
-==================
+---
+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...
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+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 
 the status bar and navigation bar with a swipe.

diff --git a/AndroidBeamDemo/README.md b/AndroidBeamDemo/README.md
@@ -1,5 +1,16 @@
-Android Beam Demo 
-=================
+---
+name: Xamarin.Android - Android Beam Demo
+description: This is a port of Android SDK samples. It demonstrates new Android Beam (new NFC feature) in Ice Cream Sandwich.
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: androidbeamdemo
+---
+# Android Beam Demo 
 
 This is a port of Android SDK samples.
 

diff --git a/AnimationDemo/README.md b/AnimationDemo/README.md
@@ -1,5 +1,16 @@
-Android Animation Demo
-======================
+---
+name: Xamarin.Android - Android Animation Demo
+description: This sample app accompanies the article, Graphics and Animations. ![](Screenshots/example-screens.png)
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: animationdemo
+---
+# Android Animation Demo
 
 This sample app accompanies the article, 
 [Graphics and Animations](http://developer.xamarin.com/guides/android/application_fundamentals/graphics_and_animation).

diff --git a/ApiDemo/README.md b/ApiDemo/README.md
@@ -1,5 +1,16 @@
-Android API Demo
-================
+---
+name: Xamarin.Android - Android API Demo
+description: 'This sample includes a variety of small applications that illustrate the use of various Android APIs. It includes samples of: - Notifications -...'
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: apidemo
+---
+# Android API Demo
 
 This sample includes a variety of small applications that illustrate
 the use of various Android APIs. It includes samples of:
@@ -16,7 +27,6 @@ the use of various Android APIs. It includes samples of:
   - Voice Recognition
   - And many many more...
 
-Build Requirements
---------
+## Build Requirements
 Building this sample requires that the API 19 (KitKat) SDK be installed,
 as well as Android SDK Build-tools 19.0.1 or greater.
diff --git a/ApplicationFundamentals/FingerPaint/README.md b/ApplicationFundamentals/FingerPaint/README.md
@@ -1,8 +1,20 @@
-Multi-Touch Tracking in Android
-=======================
+---
+name: Xamarin.Android - Multi-Touch Tracking in Android
+description: FingerPaint sample for Multi-Touch Tracking
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-fingerpaint
+---
+# Multi-Touch Tracking in Android
 
 FingerPaint sample for [Multi-Touch Tracking](/guides/android/application_fundamentals/touch/touch_tracking/)
 
-Author
-------
+![Multi-Touch Tracking in Android application screenshot](Screenshots/image01.png "Multi-Touch Tracking in Android application screenshot")
+
+## Author
 Charles Petzold
diff --git a/ApplicationFundamentals/RotationDemo/README.md b/ApplicationFundamentals/RotationDemo/README.md
@@ -1,5 +1,16 @@
-Rotation Demo
-=============
+---
+name: Xamarin.Android - Rotation Demo
+description: This sample app accompanies the article, Handling Rotation.
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-rotationdemo
+---
+# Rotation Demo
 
 This sample app accompanies the article, 
 [Handling Rotation](http://developer.xamarin.com/guides/android/application_fundamentals/handling_rotation).

diff --git a/ApplicationFundamentals/ServiceSamples/BoundServiceDemo/README.md b/ApplicationFundamentals/ServiceSamples/BoundServiceDemo/README.md
@@ -1,11 +1,23 @@
-Xamarin.Android Bound Service Sample
-====================================
+---
+name: Xamarin.Android - Xamarin.Android Bound Service Sample
+description: This directory holds the sample project from the creating a bound service section of the Creating Services guide for Xamarin.Android....
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-servicesamples-boundservicedemo
+---
+# Xamarin.Android Bound Service Sample
 
 This directory holds the sample project from the [creating a bound service section](https://developer.xamarin.com/guides/android/application_fundamentals/services/creating-a-service/bound-services/) of the [Creating Services](https://developer.xamarin.com/guides/android/application_fundamentals/services/) guide for Xamarin.Android. 
 
 ![](./Screenshots/bound-service.png)
 
-Authors
--------
+![Xamarin.Android Bound Service Sample application screenshot](Screenshots/bound-service.png "Xamarin.Android Bound Service Sample application screenshot")
+
+## Authors
 
 Tom Opgenorth (toopge@microsoft.com)
diff --git a/ApplicationFundamentals/ServiceSamples/ForegroundServiceDemo/README.md b/ApplicationFundamentals/ServiceSamples/ForegroundServiceDemo/README.md
@@ -1,11 +1,23 @@
-Xamarin.Android Foreground Service Sample
-=========================================
+---
+name: Xamarin.Android - Xamarin.Android Foreground Service Sample
+description: This directory holds the sample project from the creating a foreground service section of the Creating Services guide for Xamarin.Android....
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-servicesamples-foregroundservicedemo
+---
+# Xamarin.Android Foreground Service Sample
 
 This directory holds the sample project from the [creating a foreground service](https://developer.xamarin.com/guides/android/application_fundamentals/services/creating-a-service/bound-services/) section of the [Creating Services](https://developer.xamarin.com/guides/android/application_fundamentals/services/) guide for Xamarin.Android.
 
 ![](./Screenshots/foreground-service.png)
 
-Authors
--------
+![Xamarin.Android Foreground Service Sample application screenshot](Screenshots/foreground-service.png "Xamarin.Android Foreground Service Sample application screenshot")
+
+## Authors
 
 Tom Opgenorth (toopge@microsoft.com)
diff --git a/ApplicationFundamentals/ServiceSamples/MessengerServiceDemo/README.md b/ApplicationFundamentals/ServiceSamples/MessengerServiceDemo/README.md
@@ -1,5 +1,16 @@
-Xamarin.Android Messenger and Service Sample
-============================================
+---
+name: Xamarin.Android - Xamarin.Android Messenger and Service Sample
+description: This solution is an example of IPC communication between an Android service and an Activity (using a Messenger and a Handler). It demonstates how...
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-servicesamples-messengerservicedemo
+---
+# Xamarin.Android Messenger and Service Sample
 
 This solution is an example of IPC communication between an Android service and an Activity (using a Messenger and a Handler). It demonstates how to perform one-way and two-way IPC calls between an Activity and a Service running in it's own process.
 
@@ -10,7 +21,8 @@ Ensure that the **MessengerService** project is installed on the device _before_
 **Note**: Currently it is not possible to implement an `IsolatedProcess` in Xamarin.Android. Please see [Bugzilla 51940 -  Services with isolated processes and custom Application class fail to resolve overloads properly](https://bugzilla.xamarin.com/show_bug.cgi?id=51940) for more details.
 
 
-Authors
--------
+![Xamarin.Android Messenger and Service Sample application screenshot](Screenshots/service-messenger-activity.png "Xamarin.Android Messenger and Service Sample application screenshot")
+
+## Authors
 
 Tom Opgenorth (toopge@microsoft.com)
diff --git a/ApplicationFundamentals/ServiceSamples/StartedServicesDemo/README.md b/ApplicationFundamentals/ServiceSamples/StartedServicesDemo/README.md
@@ -1,11 +1,23 @@
-Xamarin.Android Started Service Sample
-======================================
+---
+name: Xamarin.Android - Xamarin.Android Started Service Sample
+description: This directory holds the sample project for the creating a started service section of the Creating Services guide for Xamarin.Android....
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-servicesamples-startedservicesdemo
+---
+# Xamarin.Android Started Service Sample
 
 This directory holds the sample project for the [creating a started service section](https://developer.xamarin.com/guides/android/application_fundamentals/services/creating-a-service/started-services/) of the [Creating Services](https://developer.xamarin.com/guides/android/application_fundamentals/services/) guide for Xamarin.Android. 
 
 ![](./Screenshots/started-service.png)
 
-Authors
--------
+![Xamarin.Android Started Service Sample application screenshot](Screenshots/started-service.png "Xamarin.Android Started Service Sample application screenshot")
+
+## Authors
 
 Tom Opgenorth (toopge@microsoft.com)
diff --git a/ApplicationFundamentals/Touch_final/README.md b/ApplicationFundamentals/Touch_final/README.md
@@ -1,4 +1,15 @@
-Touch in Android (Completed Sample)
-=======================
+---
+name: Xamarin.Android - Touch in Android (Completed Sample)
+description: Complete sample for Using Touch in Android
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-touch-final
+---
+# Touch in Android (Completed Sample)
 
 Complete sample for [Using Touch in Android](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/touch/part_4_android_touch_walkthrough/)
diff --git a/ApplicationFundamentals/Touch_start/README.md b/ApplicationFundamentals/Touch_start/README.md
@@ -1,4 +1,15 @@
-Touch in Android (Walkthrough)
-=====
+---
+name: Xamarin.Android - Touch in Android (Walkthrough)
+description: Walkthrough starting point for Using Touch in Android Walkthrough
+page_type: sample
+languages:
+- csharp
+products:
+- xamarin
+technologies:
+- xamarin-android
+urlFragment: applicationfundamentals-touch-start
+---
+# Touch in Android (Walkthrough)
 
 Walkthrough starting point for [Using Touch in Android Walkthrough](http://developer.xamarin.com/guides/cross-platform/application_fundamentals/touch/part_4_android_touch_walkthrough/)