Merge pull request #120 from CommunityToolkit/117-use-central-communi…

…ty-toolkit-ado-feed-for-nightlylatest-packages

Adding Azure artifacts nuget feed to publishing

.github/workflows/dotnet-ci.yml

@@ -122,3 +122,29 @@ jobs:
       - name: Publish to GitHub packages
         run: dotnet nuget push ./*.nupkg --source "https://nuget.pkg.github.com/communitytoolkit/index.json" --api-key ${{ secrets.GITHUB_TOKEN }}
 
+  publish-azure-artifacts:
+    needs: build
+    runs-on: windows-latest
+    environment:
+      name: azure-artifacts
+    steps:
+      - name: Download package
+        uses: actions/download-artifact@v4
+        with:
+          name: nuget-packages
+
+      - name: Add AzDO NuGet feed
+        run: >
+          dotnet nuget add source 
+          https://pkgs.dev.azure.com/dotnet/CommunityToolkit/_packaging/CommunityToolkit-PullRequests/nuget/v3/index.json
+          --name PullRequests
+          --username dummy
+          --password ${{ secrets.DEVOPS_PACKAGE_PUSH_TOKEN }}
+
+      - name: Push signed packages to AzDO
+        run: >
+          dotnet nuget push 
+          "${{ github.workspace }}/**/*.nupkg" 
+          --api-key dummy 
+          --source PullRequests 
+          --skip-duplicate

.github/workflows/dotnet-main.yml

@@ -219,3 +219,29 @@ jobs:
       - name: Publish to GitHub packages
         run: dotnet nuget push ./*.nupkg --source "https://nuget.pkg.github.com/communitytoolkit/index.json" --api-key ${{ secrets.GITHUB_TOKEN }}
 
+  publish-azure-artifacts:
+    needs: build
+    runs-on: windows-latest
+    environment:
+      name: azure-artifacts
+    steps:
+      - name: Download package
+        uses: actions/download-artifact@v4
+        with:
+          name: nuget-packages
+
+      - name: Add AzDO NuGet feed
+        run: >
+          dotnet nuget add source 
+          https://pkgs.dev.azure.com/dotnet/CommunityToolkit/_packaging/CommunityToolkit-MainLatest/nuget/v3/index.json
+          --name MainLatest
+          --username dummy
+          --password ${{ secrets.DEVOPS_PACKAGE_PUSH_TOKEN }}
+
+      - name: Push signed packages to AzDO
+        run: >
+          dotnet nuget push 
+          "${{ github.workspace }}/**/*.nupkg" 
+          --api-key dummy 
+          --source MainLatest 
+          --skip-duplicate

CONTRIBUTING.md

@@ -41,6 +41,10 @@ For more detailed information on how to add a new integration, refer to the [bui
 
 Also, familiarise yourself with the [versioning](./docs/versioning.md) and [diagnostics](./docs/diagnostics.md) documentation to understand the process of adding new integrations and APIs.
 
+### 🥽 Previewing Packages
+
+Each PR that builds successfully will have a preview package created. You can find the preview package in the [Azure Artifacts](https://pkgs.dev.azure.com/dotnet/CommunityToolkit/_packaging/CommunityToolkit-PullRequests/nuget/v3/index.json) feed and as artifacts attached to the build.
+
 ## 💙 Thank You
 
 **Thank you so much for contributing to this amazing project. We hope you will continue to add value and find yourself as a highly reliable source to the .NET Aspire Community Toolkit.**
@@ -51,6 +55,6 @@ Please see our [Code of Conduct](https://dotnetfoundation.org/code-of-conduct).
 
 As should be clear by now: we assume everyone tries to do their best, everyone should be treated with respect and equally.
 
-In the unfortunate event that doesn't happen, please feel free to report it to any of the team members or reach out to [Gerald](mailto:gerald.versluis@microsoft.com) directly.
+In the unfortunate event that doesn't happen, please feel free to report it to any of the team members or reach out to [Aaron](mailto:aaron.powell@microsoft.com) directly.
 
 We will take appropriate actions and measures if necessary.

README.md

@@ -25,6 +25,17 @@ This repository contains the source code for the .NET Aspire Community Toolkit,
 
 Each of the integrations in the toolkit is available as a NuGet package, and can be added to your .NET project. Refer to the table above for the available integrations and the documentation on how to use them.
 
+### 📦 Installation
+
+Stable releases of the NuGet packages will be published to the [NuGet Gallery](https://www.nuget.org/packages?q=aspire.communitytoolkit). For pre-release versions, you can use Azure Artifacts feeds:
+
+-   [View latest `main` branch packages](https://dev.azure.com/dotnet/CommunityToolkit/_packaging?_a=feed&feed=CommunityToolkit-MainLatest)
+    -   [Feed URL](https://pkgs.dev.azure.com/dotnet/CommunityToolkit/_packaging/CommunityToolkit-MainLatest/nuget/v3/index.json)
+-   [View latest PR build packages](https://dev.azure.com/dotnet/CommunityToolkit/_packaging?_a=feed&feed=CommunityToolkit-PullRequests)
+    -   [Feed URL](https://pkgs.dev.azure.com/dotnet/CommunityToolkit/_packaging/CommunityToolkit-PullRequests/nuget/v3/index.json)
+
+_Stable releases are not published to the Azure Artifacts feeds, they can only be accessed from the NuGet Gallery._
+
 ## 📃 Documentation
 
 Documentation for the .NET Aspire Community Toolkit is available on the [Microsoft Docs](https://learn.microsoft.com/dotnet/aspire/community-toolkit/overview).
@@ -78,4 +89,3 @@ This project is supported by the [.NET Foundation](https://dotnetfoundation.org)
 [ollamasharp-nuget]: https://nuget.org/packages/Aspire.CommunityToolkit.OllamaSharp/
 [ollamasharp-shields-preview]: https://img.shields.io/nuget/v/Aspire.CommunityToolkit.OllamaSharp?label=nuget%20(preview)
 [ollamasharp-nuget-preview]: https://nuget.org/packages/Aspire.CommunityToolkit.OllamaSharp/absoluteLatest
-

docs/faq.md

@@ -2,15 +2,15 @@
 
 ## What is the purpose of this project?
 
-The goal of the project is to be a centralised home for extensions and integrations for [.NET Aspire](/dotnet/aspire), helping to provide consistency in the way that integrations are built and maintained, as well as easier discoverability for users.
+The goal of the project is to be a centralised home for extensions and integrations for [.NET Aspire](https://aka.ms/dotnet/aspire), helping to provide consistency in the way that integrations are built and maintained, as well as easier discoverability for users.
 
 ## How is this project different from the official .NET Aspire project?
 
 The .NET Aspire Community Toolkit is a community-driven project that is maintained by the community and is not officially supported by the .NET Aspire team. The toolkit is a collection of integrations and extensions that are built on top of the .NET Aspire project.
 
 ## How can I contribute to the project?
 
-Anyone can contribute to the .NET Aspire Community Toolkit and before you get started, be sure to read the [Contributing Guide](https://github.com/CommunityToolkit/Aspire/blob/main/CONTRIBUTING.md) to learn how to contribute to the project.
+Anyone can contribute to the .NET Aspire Community Toolkit and before you get started, be sure to read the [Contributing Guide](../CONTRIBUTING.md) to learn how to contribute to the project.
 
 ## Should I propose a new integration here on or the `dotnet/aspire` repo?
 

docs/versioning.md

@@ -14,4 +14,4 @@ Releases are automated using GitHub Actions, each release will be tagged in the
 
 ## Preview and Pull Request Builds
 
-Preview builds are created for each pull request and are available as assets of the workflow run, as well as via GitHub Packages (where applicable). These builds are not intended for production use and may contain bugs or incomplete features, so will be marked with pre-release tags.
+Preview builds are created for each pull request and are available as assets of the workflow run, as well as via Azure Artifacts (where applicable). These builds are not intended for production use and may contain bugs or incomplete features, so will be marked with pre-release tags.