update readme for ga (dotnet#776)

Author: danmoseley

docs/contributing.md

@@ -0,0 +1,39 @@
+# Set up your machine to contribute
+
+These instructions will get you ready to contribute to this project. If you just want to use Aspire, see [using-latest-daily.md](using-latest-daily.md).
+
+## Prepare the machine
+
+See [machine-requirements.md](machine-requirements.md).
+
+## Build the repo
+`.\build.cmd` (Windows) or `.\build.sh` (macOS and Linux)
+
+
+## Run eShopLite
+
+This will confirm that you're all set up.
+
+If you are using Visual Studio:
+
+1. Open `Aspire.sln`
+1. Set the Startup Project to be the `AppHost` project (it's under `\samples\eShopLite`). Make sure the launch profile is set to "http".
+1. <kbd>F5</kbd> to debug, or <kbd>Ctrl+F5</kbd> to launch without debugging.
+
+Otherwise:
+```shell
+dotnet restore samples/eShopLite/AppHost/AppHost.csproj
+dotnet run --project samples/eShopLite/AppHost/AppHost.csproj
+```
+
+## View Dashboard
+
+When you start the sample app in Visual Studio, it will automatically open your browser to show the dashboard.
+
+Otherwise if you are using the command line, when you have the Aspire app running, open the dashboard URL in your browser. The URL is shown in the app's console output like this: `Now listening on: http://localhost:15888`. You can change the default URL in the launchSettings.json file in the AppHost project.
+
+## Tips and known issues
+
+Make sure you have started Docker before trying to run an Aspire app.
+
+See the [tips and known issues](tips-and-known-issues.md) page.

docs/getting-started.md

@@ -1,20 +1,21 @@
 # Set up your environment
 
-## Install Visual Studio 2022 Internal Preview (dogfood)
+Whether you want to contribute to Aspire, or just use the latest build of Aspire, these are the common pieces you need to install.
 
-[Visual Studio 2022 Enterprise IntPreview Setup](https://aka.ms/vs/17/intpreview/vs_enterprise.exe)
-    - This channel updates nightly. You need a build from 12-Oct-2023 or later.
+## (Windows) Install Visual Studio
 
-## Install .NET 8 RTM nightly SDK
+On Windows, Visual Studio contains special tooling support for .NET Aspire that you will want to have.
 
-Install the .NET 8 RTM nightly SDK version 8.0.100-rtm.23512.16 or newer:
-   1. [Windows x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rtm.23512.16/dotnet-sdk-8.0.100-rtm.23512.16-win-x64.exe)
-   2. [Linux x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rtm.23512.16/dotnet-sdk-8.0.100-rtm.23512.16-linux-x64.tar.gz)
-   3. [MacOS x64 link](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rtm.23512.16/dotnet-sdk-8.0.100-rtm.23512.16-osx-x64.tar.gz)
-   4. [MacOS ARM64](https://dotnetbuilds.azureedge.net/public/Sdk/8.0.100-rtm.23512.16/dotnet-sdk-8.0.100-rtm.23512.16-osx-arm64.tar.gz)
+[Visual Studio 2022 version 17.9 Preview](https://visualstudio.microsoft.com/vs/preview/)
+
+When you install, ensure that both:
+* `ASP.NET and web development` Workload is checked.
+* `.NET Aspire SDK` component in `Individual components` is checked.
+
+## Install the latest .NET 8 SDK
+[.NET 8 SDK](https://github.com/dotnet/installer#installers-and-binaries)
 
 ## Install Docker Desktop
 * [Windows](https://docs.docker.com/desktop/install/windows-install/)
 * [MacOS X](https://docs.docker.com/desktop/install/mac-install/)
 * [Linux](https://docs.docker.com/desktop/install/linux-install/)
-

docs/machine-requirements.md

@@ -0,0 +1,54 @@
+# Set up your machine to use the latest Aspire builds
+
+These instructions will get you set up with the latest build of Aspire. If you just want the last preview release of .NET Aspire, the packages are on nuget.org, and install the latest [Visual Studio 2022 version 17.9 Preview](https://visualstudio.microsoft.com/vs/preview/) for the tooling.
+
+## Prepare the machine
+
+See [machine-requirements.md](machine-requirements.md).
+
+## Add necessary NuGet feeds
+
+The latest builds are pushed to a special feed, which you need to add:
+```sh
+dotnet nuget add source --name dotnet8 https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json
+```
+
+As usual this will add the feed to any existing NuGet.config in the directory or above, or else in the global NuGet.config. See [configuring NuGet behavior](https://learn.microsoft.com/en-us/nuget/consume-packages/configuring-nuget-behavior) to read more about that.
+
+Alternatively, if you are using Visual Studio, you can [Install and manage packages in Visual Studio](https://learn.microsoft.com/nuget/consume-packages/install-use-packages-visual-studio#package-sources) and add the feed `https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json` there.
+
+## Install the .NET Aspire dotnet workload
+
+This will actually get Aspire components.
+
+```shell
+dotnet workload install aspire --skip-sign-check --interactive --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json
+# To update it later if you wish
+# dotnet workload update --source https://pkgs.dev.azure.com/dnceng/public/_packaging/dotnet8/nuget/v3/index.json
+```
+
+Now you are ready to create and run an Aspire app using these latest Aspire components.
+
+## Create a new Project
+
+Create an empty .NET Aspire project on the command line:
+```shell
+dotnet new aspire
+# Alternatively, to create a .NET Aspire project using the Starter template:
+# dotnet new aspire-starter
+```
+
+These will create a `.sln` file and at least two projects.
+
+Assuming the NuGet feed you added above is visible -- for example you added it globally or it's in a NuGet.config in this folder - you can now build that `.sln`
+```shell
+dotnet restore
+dotnet build
+```
+
+And then run it (make sure that Docker desktop is started):
+```shell
+dotnet run --project "<directoryname>.AppHost"
+```
+
+Alternatively, if you are using Visual Studio, you can instead create a new Blazor Web App project and check the `Enlist in Aspire orchestration` box while creating it. Then use <kbd>F5</kbd> to debug or <kbd>Ctrl+F5</kbd> to launch without debugging.