From 0d3a573e53fb0eeae5053fdbe121d958feb5b04a Mon Sep 17 00:00:00 2001
From: Repo Assist <copilot@github.com>
Date: Sun, 8 Mar 2026 13:35:21 +0000
Subject: [PATCH 1/2] Fix docs: switch to fsdocs-tool 21, fix namespace
 substitution

- Replace fsharp.formatting.commandtool 11.4.3 with fsdocs-tool 21.0.0
  The old tool used MSBuild v15.1.0.0 which can't load the
  SetRidAgnosticValueForProjects task from .NET SDK 8.x, causing project
  cracking to fail silently. fsdocs-tool 21 uses Ionide.ProjInfo
  for cracking and targets net8.0, resolving this incompatibility.
- Fix {{package-version}} -> {{fsdocs-package-version}} in all docs .fsx
  files (correct fsdocs substitution key)
- Add FsDocsLicenseLink and FsDocsReleaseNotesLink to project file so
  License and Release Notes nav links are properly populated

Closes #269

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .config/dotnet-tools.json                                  | 4 ++--
 docs/AsyncSeq.fsx                                          | 4 ++--
 docs/AsyncSeqExamples.fsx                                  | 4 ++--
 docs/ComparisonWithObservable.fsx                          | 4 ++--
 src/FSharp.Control.AsyncSeq/FSharp.Control.AsyncSeq.fsproj | 2 ++
 5 files changed, 10 insertions(+), 8 deletions(-)

diff --git a/.config/dotnet-tools.json b/.config/dotnet-tools.json
index 2ed8ad1..abe1f9a 100644
--- a/.config/dotnet-tools.json
+++ b/.config/dotnet-tools.json
@@ -2,8 +2,8 @@
   "version": 1,
   "isRoot": true,
   "tools": {
-    "fsharp.formatting.commandtool": {
-      "version": "11.4.3",
+    "fsdocs-tool": {
+      "version": "21.0.0",
       "commands": [
         "fsdocs"
       ],
diff --git a/docs/AsyncSeq.fsx b/docs/AsyncSeq.fsx
index 409d99c..c34354f 100644
--- a/docs/AsyncSeq.fsx
+++ b/docs/AsyncSeq.fsx
@@ -4,11 +4,11 @@
 #r "FSharp.Control.AsyncSeq.dll"
 (*** condition: fsx ***)
 #if FSX
-#r "nuget: FSharp.Control.AsyncSeq,{{package-version}}"
+#r "nuget: FSharp.Control.AsyncSeq,{{fsdocs-package-version}}"
 #endif // FSX
 (*** condition: ipynb ***)
 #if IPYNB
-#r "nuget: FSharp.Control.AsyncSeq,{{package-version}}"
+#r "nuget: FSharp.Control.AsyncSeq,{{fsdocs-package-version}}"
 #endif // IPYNB
 
 
diff --git a/docs/AsyncSeqExamples.fsx b/docs/AsyncSeqExamples.fsx
index 605de65..546d6fb 100644
--- a/docs/AsyncSeqExamples.fsx
+++ b/docs/AsyncSeqExamples.fsx
@@ -4,11 +4,11 @@
 #r "FSharp.Control.AsyncSeq.dll"
 (*** condition: fsx ***)
 #if FSX
-#r "nuget: FSharp.Control.AsyncSeq,{{package-version}}"
+#r "nuget: FSharp.Control.AsyncSeq,{{fsdocs-package-version}}"
 #endif // FSX
 (*** condition: ipynb ***)
 #if IPYNB
-#r "nuget: FSharp.Control.AsyncSeq,{{package-version}}"
+#r "nuget: FSharp.Control.AsyncSeq,{{fsdocs-package-version}}"
 #endif // IPYNB
 
 (**
diff --git a/docs/ComparisonWithObservable.fsx b/docs/ComparisonWithObservable.fsx
index 4f27a4f..45c982f 100644
--- a/docs/ComparisonWithObservable.fsx
+++ b/docs/ComparisonWithObservable.fsx
@@ -4,11 +4,11 @@
 #r "FSharp.Control.AsyncSeq.dll"
 (*** condition: fsx ***)
 #if FSX
-#r "nuget: FSharp.Control.AsyncSeq,{{package-version}}"
+#r "nuget: FSharp.Control.AsyncSeq,{{fsdocs-package-version}}"
 #endif // FSX
 (*** condition: ipynb ***)
 #if IPYNB
-#r "nuget: FSharp.Control.AsyncSeq,{{package-version}}"
+#r "nuget: FSharp.Control.AsyncSeq,{{fsdocs-package-version}}"
 #endif // IPYNB
 
 
diff --git a/src/FSharp.Control.AsyncSeq/FSharp.Control.AsyncSeq.fsproj b/src/FSharp.Control.AsyncSeq/FSharp.Control.AsyncSeq.fsproj
index 5c91481..20a5fe8 100644
--- a/src/FSharp.Control.AsyncSeq/FSharp.Control.AsyncSeq.fsproj
+++ b/src/FSharp.Control.AsyncSeq/FSharp.Control.AsyncSeq.fsproj
@@ -9,6 +9,8 @@
     <PackageProjectUrl>https://fsprojects.github.io/FSharp.Control.AsyncSeq/</PackageProjectUrl>
     <PackageIconUrl>https://fsprojects.github.io/FSharp.Control.AsyncSeq/img/logo.png</PackageIconUrl>
     <PackageTags>F#;async;fsharp;streaming</PackageTags>
+    <FsDocsLicenseLink>https://github.com/fsprojects/FSharp.Control.AsyncSeq/blob/main/LICENSE.md</FsDocsLicenseLink>
+    <FsDocsReleaseNotesLink>https://github.com/fsprojects/FSharp.Control.AsyncSeq/blob/main/RELEASE_NOTES.md</FsDocsReleaseNotesLink>
     <IncludeSymbols>true</IncludeSymbols>
     <RepositoryUrl>https://github.com/fsprojects/FSharp.Control.AsyncSeq</RepositoryUrl>
     <SymbolPackageFormat>snupkg</SymbolPackageFormat>

From 06c6fd7643f71288b20a38d04ce27a83d21af79a Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Sun, 8 Mar 2026 13:38:23 +0000
Subject: [PATCH 2/2] ci: trigger checks