Modify README to include usage information and resources.

README.md

@@ -1,4 +1,57 @@
-dotnet-apiport
-==============
+# .NET API Port
 
-This repo contains APIPort client tools and libraries
+This repository contains the source code for APIPort client tools and dependencies. This 
+is a work in progress, and does not currently contain all of the components 
+that we plan on open sourcing. Make sure to watch this repository in order to 
+be notified as we make changes to and expand it.
+
+Today, the repository contains the following components:
+
+* **Microsoft.Fx.Portability**. Provides common types for API Port.
+
+* **Microsoft.Fx.Portability Tests**. Provides tests for Microsoft.Fx.Portability.
+
+More libraries are coming soon. Stay tuned!
+
+## Using this Repository
+
+1. Install the following:
+    1. [Visual Studio 2015](http://www.visualstudio.com/en-us/downloads/visual-studio-2015-downloads-vs.aspx)
+    2. [K Version Manager (KVM)](https://github.com/aspnet/home#install-the-k-version-manager-kvm)
+    3. [K Runtime (KRE)](https://github.com/aspnet/home#install-the-k-runtime-environment-kre)
+
+2. Add this feed to your NuGet package sources: https://www.myget.org/F/aspnetvnext/api/v2
+    * Wiki: [Configuring feeds used by KPM to Restore Packages](https://github.com/aspnet/Home/wiki/Configuring-the-feed-used-by-kpm-to-restore-packages)
+3. Open Microsoft.Fx.Portability.sln in Visual Studio 2015
+4. Build the solution
+5. The .nupkgs for each supported platform should be under the bin/Debug or bin/Release folder
+
+## How to Engage, Contribute and Provide Feedback
+
+Some of the best ways to contribute are to try things out, file bugs, and join in design conversations. 
+
+Want to get more familiar with what's going on in the code?
+
+* [Pull requests](https://github.com/Microsoft/dotnet-apiport/pulls): [Open](https://github.com/Microsoft/dotnet-apiport/pulls?q=is%3Aopen+is%3Apr)/[Closed](https://github.com/Microsoft/dotnet-apiport/pulls?q=is%3Apr+is%3Aclosed)
+
+Looking for something to work on? The list of [up-for-grabs issues](https://github.com/Microsoft/dotnet-apiport/issues?q=is%3Aopen+is%3Aissue) is a great place to start.
+
+We're re-using the same contributing approach as .NET Core. You can check out the .NET Core [contributing guide][Contributing Guide] at the corefx repo wiki for more details.
+
+* [How to Contribute][Contributing Guide]
+    * [Contributing Guide][Contributing Guide]
+    * [Developer Guide]
+
+You are also encouraged to start a discussion on the .NET Foundation forums!
+
+[Contributing Guide]: https://github.com/dotnet/corefx/wiki/Contributing
+[Developer Guide]: https://github.com/dotnet/corefx/wiki/Developer-Guide
+
+## Related Projects
+
+For an overview of all the .NET related projects, have a look at the
+[.NET home repository](https://github.com/Microsoft/dotnet).
+
+## License
+
+This project is licensed under the [MIT license](LICENSE).