Markdown and edit fixes. (#528)

README.md

@@ -2,7 +2,7 @@
 
 Xamarin.Essentials gives developers essential cross-platform APIs for their mobile applications. 
 
-iOS, Android, and UWP offer unique operating system and platform APIs that developers have access to all in C# leveraging Xamarin. It is great that developers have 100% API access in C# with Xamarin, but these APIs are different per platform. This means developers have to learn three different APIs to access platform specific features. With Xamarin.Essentials developers have a single cross-platform API that works with any iOS, Android, or UWP application that can be accessed from shared code no matter how the user interface is created.
+iOS, Android, and UWP offer unique operating system and platform APIs that developers have access to, all in C# leveraging Xamarin. It is great that developers have 100% API access in C# with Xamarin, but these APIs are different per platform. This means developers have to learn three different APIs to access platform-specific features. With Xamarin.Essentials, developers have a single cross-platform API that works with any iOS, Android, or UWP application that can be accessed from shared code no matter how the user interface is created.
 
 [![Gitter chat](https://badges.gitter.im/gitterHQ/gitter.png)](https://gitter.im/xamarin/Essentials)
 
@@ -17,7 +17,9 @@ iOS, Android, and UWP offer unique operating system and platform APIs that devel
 | App Center   | Sample App   | iOS      | [![Build status](https://build.appcenter.ms/v0.1/apps/43b39e9e-2b2b-482f-8afa-e9906334c85e/branches/master/badge)](https://appcenter.ms) |
 
 ## Installation
+
 Xamarin.Essentials is available via:
+
 * NuGet Official Releases: [![NuGet](https://img.shields.io/nuget/vpre/Xamarin.Essentials.svg?label=NuGet)](https://www.nuget.org/packages/Xamarin.Essentials)
 * MyGet Development Feed: https://www.myget.org/F/xamarin-essentials/api/v3/index.json
 
@@ -25,65 +27,73 @@ Please read our [Getting Started with Xamarin.Essentials guide](https://docs.mic
 
 ## Documentation
 
-Browse our [full documentation for Xamarin.Essentials](https://docs.microsoft.com/xamarin/essentials) including feature guides on how to use each feature.
+Browse our [full documentation for Xamarin.Essentials](https://docs.microsoft.com/xamarin/essentials), including feature guides, on how to use each feature.
 
 ## Supported Platforms
-Xamarin.Essentials is focused on the following platforms:
- - iOS (10+)
- - Android (4.4+)
- - UWP (Fall Creators Update+)
 
-## API Documentation:
+Xamarin.Essentials is focused on the following platforms:
+
+* iOS (10+)
+* Android (4.4+)
+* UWP (Fall Creators Update+)
+
+## API Documentation
+
 The following cross-platform APIs are available in Xamarin.Essentials:
- - [Accelerometer](https://docs.microsoft.com/xamarin/essentials/accelerometer)
- - [App Information](https://docs.microsoft.com/xamarin/essentials/app-information)
- - [Battery](https://docs.microsoft.com/xamarin/essentials/battery)
- - [Clipboard](https://docs.microsoft.com/xamarin/essentials/clipboard)
- - [Compass](https://docs.microsoft.com/xamarin/essentials/compass)
- - [Connectivity](https://docs.microsoft.com/xamarin/essentials/connectivity)
- - [Data Transfer (Share)](https://docs.microsoft.com/xamarin/essentials/data-transfer)
- - [Device Display Information](https://docs.microsoft.com/en-us/xamarin/essentials/device-display)
- - [Device Information](https://docs.microsoft.com/xamarin/essentials/device-information)
- - [Email](https://docs.microsoft.com/xamarin/essentials/email)
- - [File System Helpers](https://docs.microsoft.com/xamarin/essentials/file-system-helpers)
- - [Flashlight](https://docs.microsoft.com/xamarin/essentials/flashlight)
- - [Geocoding](https://docs.microsoft.com/xamarin/essentials/geocoding)
- - [Geolocation](https://docs.microsoft.com/xamarin/essentials/geolocation)
- - [Gyroscope](https://docs.microsoft.com/xamarin/essentials/gyroscope)
- - [Launcher](https://docs.microsoft.com/xamarin/essentials/launcher)
- - [Magnetometer](https://docs.microsoft.com/xamarin/essentials/magnetometer)
- - [MainThread](https://docs.microsoft.com/xamarin/essentials/main-thread)
- - [Maps](https://docs.microsoft.com/xamarin/essentials/maps)
- - [Open Browser](https://docs.microsoft.com/xamarin/essentials/open-browser)
- - [Orientation Sensor](https://docs.microsoft.com/en-us/xamarin/essentials/orientation-sensor)
- - [Phone Dialer](https://docs.microsoft.com/xamarin/essentials/phone-dialer)
- - [Power](https://docs.microsoft.com/en-us/xamarin/essentials/power)
- - [Preferences](https://docs.microsoft.com/xamarin/essentials/preferences)
- - [Screen Lock](https://docs.microsoft.com/xamarin/essentials/screen-lock)
- - [Secure Storage](https://docs.microsoft.com/xamarin/essentials/secure-storage)
- - [SMS](https://docs.microsoft.com/xamarin/essentials/sms)
- - [Text-to-Speech](https://docs.microsoft.com/xamarin/essentials/text-to-speech)
- - [Version Tracking](https://docs.microsoft.com/xamarin/essentials/version-tracking)
- - [Vibrate](https://docs.microsoft.com/xamarin/essentials/vibrate)
- 
+
+* [Accelerometer](https://docs.microsoft.com/xamarin/essentials/accelerometer)
+* [App Information](https://docs.microsoft.com/xamarin/essentials/app-information)
+* [Battery](https://docs.microsoft.com/xamarin/essentials/battery)
+* [Clipboard](https://docs.microsoft.com/xamarin/essentials/clipboard)
+* [Compass](https://docs.microsoft.com/xamarin/essentials/compass)
+* [Connectivity](https://docs.microsoft.com/xamarin/essentials/connectivity)
+* [Data Transfer (Share)](https://docs.microsoft.com/xamarin/essentials/data-transfer)
+* [Device Display Information](https://docs.microsoft.com/en-us/xamarin/essentials/device-display)
+* [Device Information](https://docs.microsoft.com/xamarin/essentials/device-information)
+* [Email](https://docs.microsoft.com/xamarin/essentials/email)
+* [File System Helpers](https://docs.microsoft.com/xamarin/essentials/file-system-helpers)
+* [Flashlight](https://docs.microsoft.com/xamarin/essentials/flashlight)
+* [Geocoding](https://docs.microsoft.com/xamarin/essentials/geocoding)
+* [Geolocation](https://docs.microsoft.com/xamarin/essentials/geolocation)
+* [Gyroscope](https://docs.microsoft.com/xamarin/essentials/gyroscope)
+* [Launcher](https://docs.microsoft.com/xamarin/essentials/launcher)
+* [Magnetometer](https://docs.microsoft.com/xamarin/essentials/magnetometer)
+* [MainThread](https://docs.microsoft.com/xamarin/essentials/main-thread)
+* [Maps](https://docs.microsoft.com/xamarin/essentials/maps)
+* [Open Browser](https://docs.microsoft.com/xamarin/essentials/open-browser)
+* [Orientation Sensor](https://docs.microsoft.com/en-us/xamarin/essentials/orientation-sensor)
+* [Phone Dialer](https://docs.microsoft.com/xamarin/essentials/phone-dialer)
+* [Power](https://docs.microsoft.com/en-us/xamarin/essentials/power)
+* [Preferences](https://docs.microsoft.com/xamarin/essentials/preferences)
+* [Screen Lock](https://docs.microsoft.com/xamarin/essentials/screen-lock)
+* [Secure Storage](https://docs.microsoft.com/xamarin/essentials/secure-storage)
+* [SMS](https://docs.microsoft.com/xamarin/essentials/sms)
+* [Text-to-Speech](https://docs.microsoft.com/xamarin/essentials/text-to-speech)
+* [Version Tracking](https://docs.microsoft.com/xamarin/essentials/version-tracking)
+* [Vibrate](https://docs.microsoft.com/xamarin/essentials/vibrate)
+
 ## Contributing
-Please read through our [Contribution Guide](CONTRIBUTING.md). We are not accepting new PRs for full features, however any issue that is marked as `up for grabs` are open for community contributions. We encourage creating new issues for bugs found during usage that the team will triage. Additionally, we are open for code refactoring suggestions in PRs.
+
+Please read through our [Contribution Guide](CONTRIBUTING.md). We are not accepting new PRs for full features, however any [issue that is marked as `up for grabs`](https://github.com/xamarin/Essentials/issues?q=is%3Aissue+is%3Aopen+label%3A%22up+for+grabs%22) are open for community contributions. We encourage creating new issues for bugs found during usage that the team will triage. Additionally, we are open for code refactoring suggestions in PRs.
 
 ## Building Xamarin.Essentials
-Xamarin.Essentials is built with the new SDK style projects with multi-targeting enabled. This means that all code for iOS, Android, and UWP exist inside of the Xamarin.Essentials project. 
 
-If building on Visual Studio 2017 you will need the following SDKs and workloads installed:
+Xamarin.Essentials is built with the new SDK-style projects with multi-targeting enabled. This means that all code for iOS, Android, and UWP exist inside of the Xamarin.Essentials project.
+
+If building on Visual Studio 2017, you will need the following SDKs and workloads installed:
 
 ### Workloads need:
-- Xamarin
-- .NET Core
-- UWP
+
+* Xamarin
+* .NET Core
+* UWP
 
 ### You will need the following SDKs
-- Android 8.1 SDK Installed
-- UWP 10.0.16299 SDK Installed
 
-If using Visual Studio for Mac the project can be built at the command line with MSBuild. To change the project type that you are working with simply edit Xamarin.Essentials.csproj and modify the TargetFrameworks for only the project type you want to use.
+* Android 8.1 SDK Installed
+* UWP 10.0.16299 SDK Installed
+
+If using Visual Studio for Mac the project can be built at the command line with MSBuild. To change the project type that you are working with, simply edit Xamarin.Essentials.csproj and modify the TargetFrameworks for only the project type you want to use.
 
 To build through the command line, navigate to where Xamarin.Essentials.csproj exists then run:
 
@@ -93,7 +103,9 @@ msbuild Xamarin.Essentials.csproj
 ```
 
 ## FAQ
+
 Here are some frequently asked questions about Xamarin.Essentials, but be sure to read our full [FAQ on our Wiki](https://github.com/xamarin/Essentials/wiki#feature-faq).
 
 ## License
+
 Please see the [License](LICENSE).