From e2075afafe25dd0c2d090ab4032dbacbbcd32b0c Mon Sep 17 00:00:00 2001
From: Jonathan Gilbert <logic@deltaq.org>
Date: Fri, 21 Nov 2025 16:08:16 -0600
Subject: [PATCH] Explain the parameter `-UseNuGetOrg` in build documentation
 (#26507)

---
 docs/building/linux.md        | 2 ++
 docs/building/macos.md        | 2 ++
 docs/building/windows-core.md | 2 ++
 3 files changed, 6 insertions(+)

diff --git a/docs/building/linux.md b/docs/building/linux.md
index bd7f9aadf6..6ccf12073e 100644
--- a/docs/building/linux.md
+++ b/docs/building/linux.md
@@ -64,6 +64,8 @@ Import-Module ./build.psm1
 Start-PSBuild -UseNuGetOrg
 ```
 
+> The PowerShell project by default references packages from the private Azure Artifacts feed, which requires authentication. The `-UseNuGetOrg` flag reconfigures the build to use the public NuGet.org feed instead.
+
 Congratulations! If everything went right, PowerShell is now built.
 The `Start-PSBuild` script will output the location of the executable:
 
diff --git a/docs/building/macos.md b/docs/building/macos.md
index 4f15e3fb54..7fd767ffa1 100644
--- a/docs/building/macos.md
+++ b/docs/building/macos.md
@@ -37,3 +37,5 @@ We cannot do this for you in the build module due to #[847][].
 Start a PowerShell session by running `pwsh`, and then use `Start-PSBuild -UseNuGetOrg` from the module.
 
 After building, PowerShell will be at `./src/powershell-unix/bin/Debug/net6.0/osx-x64/publish/pwsh`.
+
+> The PowerShell project by default references packages from the private Azure Artifacts feed, which requires authentication. The `-UseNuGetOrg` flag reconfigures the build to use the public NuGet.org feed instead.
diff --git a/docs/building/windows-core.md b/docs/building/windows-core.md
index 48e5c95163..20774695fc 100644
--- a/docs/building/windows-core.md
+++ b/docs/building/windows-core.md
@@ -61,6 +61,8 @@ Import-Module ./build.psm1
 Start-PSBuild -Clean -PSModuleRestore -UseNuGetOrg
 ```
 
+> The PowerShell project by default references packages from the private Azure Artifacts feed, which requires authentication. The `-UseNuGetOrg` flag reconfigures the build to use the public NuGet.org feed instead.
+
 Congratulations! If everything went right, PowerShell is now built and executable as `./src/powershell-win-core/bin/Debug/net6.0/win7-x64/publish/pwsh.exe`.
 
 This location is of the form `./[project]/bin/[configuration]/[framework]/[rid]/publish/[binary name]`,