Update README (microsoft#169)

* First version

* Links added

* Update README.md

Co-authored-by: Kevin Larkin (MS) <[email protected]>

README.md

@@ -1,6 +1,65 @@
+# Welcome to the Windows Package Manager Client (aka winget) repository
+
+This repository contains the source code for the Window Package Manager Client (aka winget).
+
+The packages available to the client are in the [Community repo](https://github.com/microsoft/winget-pkgs).
+
+> The Windows Package Manager project is in Preview. We welcome all feedback, and that feedback might lead to big (maybe even breaking) changes.
+
+## Installing the client
+
+> The client requires Windows 10 1709 (build 16299) or later at this time.
+
+### Microsoft Store [Recommended]
+
+The client is distributed within the [App Installer](ms-windows-store://pdp/?productid=9nblggh4nns1) package. While this package is pre-installed on Windows, the client will not be made generally available during the Preview period. In order to get automatic updates from the Microsoft Store that contain the client, one must do one of the following:
+
+* Install a [Windows 10 Insider](https://insider.windows.com/) build
+* Join the Preview flight ring by sending a request to [email protected]
+
+### Manually Update
+
+The same Microsoft Store package will be made available via our [Releases](https://github.com/microsoft/winget-cli/releases). Note that installing this package will give you the WinGet client, but it will not enable automatic updates from the Microsoft Store.
+
+> You may need to install the [Desktop Bridge VC++ v14 Redistributable Package](https://www.microsoft.com/en-us/download/details.aspx?id=53175) and the associated Microsoft.VCLibs.140.00.UWPDesktop package.
+> This should only be necessary on older builds of Windows if you get an error about missing framework packages.
+
+### Build your own
+
+You can also [build the client yourself](#building-the-client). While the client should be perfectly functional, we are not ready to provide full support for clients running outside of the official distribution mechanisms yet. Feel free to file an Issue, but know that it may get lower prioritization.
+
+## Build Status
+
 [![Build Status](https://dev.azure.com/ms/winget-cli/_apis/build/status/microsoft.winget-cli?branchName=master)](https://dev.azure.com/ms/winget-cli/_build/latest?definitionId=344&branchName=master)
 
-# Contributing
+## Overview
+
+TBD
+
+## Resources
+
+TBD
+
+## Building the client
+
+### Prerequisites
+
+* Windows 10 1709 (16299) or later
+* [Developer Mode enabled](https://docs.microsoft.com/en-us/windows/uwp/get-started/enable-your-device-for-development)
+* [Visual Studio 2019](https://visualstudio.microsoft.com/downloads/)
+   * Or use winget to install it ;) (although you may need to adjust the workloads via Tools->Get Tools and Features...)
+* The following workloads:
+   * .NET Desktop Development
+   * Desktop Development with C++
+   * Universal Windows Platform Development
+* The following extensions:
+   * [Microsoft Visual Studio Installer Projects](https://marketplace.visualstudio.com/items?itemName=VisualStudioClient.MicrosoftVisualStudio2017InstallerProjects)
+
+### Building
+
+We currently only build using the solution; command line methods of building a VS solution should work as well.
+
+## Contributing
 
 This project welcomes contributions and suggestions.  Most contributions require you to agree to a
 Contributor License Agreement (CLA) declaring that you have the right to, and actually do, grant us
@@ -14,8 +73,6 @@ This project has adopted the [Microsoft Open Source Code of Conduct](https://ope
 For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or
 contact [[email protected]](mailto:[email protected]) with any additional questions or comments.
 
-
-# Data/Telemetry
+## Data/Telemetry
 
 This project collects usage data and sends it to Microsoft to help improve our products and services. See the [privacy statement](privacy.md) for more details.
-