[Repo Assist] Fix docs: switch to fsdocs-tool 21.0.0 to resolve namespace substitution (fixes #269) (#270)

* 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 <[email protected]>

* ci: trigger checks

---------

Co-authored-by: Repo Assist <[email protected]>
Co-authored-by: Copilot <[email protected]>
Co-authored-by: github-actions[bot] <github-actions[bot]@users.noreply.github.com>

Author: 3 people

.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"
       ],

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
 
 

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
 
 (**

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
 
 

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>