From f364e3b9231de3e9fd9833d92c8737254ea74d06 Mon Sep 17 00:00:00 2001
From: Chris Martinez <sydefekt@hotmail.com>
Date: Wed, 5 Aug 2026 20:27:24 -0700
Subject: [PATCH 1/2] Add tooling for mapping the old wiki pages to the new
 GitHub Pages site

---
 .github/workflows/gh-pages.yml   |  13 ++-
 wiki/tools/README.md             |  99 ++++++++++++++++++++
 wiki/tools/Test-Links.ps1        | 142 +++++++++++++++++++++++++++++
 wiki/tools/make-wiki-stubs.ps1   | 149 +++++++++++++++++++++++++++++++
 wiki/tools/wiki-redirect-map.tsv |  54 +++++++++++
 5 files changed, 456 insertions(+), 1 deletion(-)
 create mode 100644 wiki/tools/README.md
 create mode 100644 wiki/tools/Test-Links.ps1
 create mode 100644 wiki/tools/make-wiki-stubs.ps1
 create mode 100644 wiki/tools/wiki-redirect-map.tsv

diff --git a/.github/workflows/gh-pages.yml b/.github/workflows/gh-pages.yml
index 728602e1..09cea5fb 100644
--- a/.github/workflows/gh-pages.yml
+++ b/.github/workflows/gh-pages.yml
@@ -30,10 +30,21 @@ jobs:
         curl -sSL $url | tar -xz --directory=./mdbook
         echo `pwd`/mdbook >> $GITHUB_PATH
 
-    - name: Deploy GitHub Pages
+    - name: Build Documentation
       run: |
         cd wiki
         mdbook build
+
+    # mdBook rewrites .md links to .html without verifying the target exists, so a
+    # renamed or removed page builds cleanly and 404s in production. This also checks
+    # that the legacy wiki redirect map still resolves.
+    - name: Check Links
+      shell: pwsh
+      run: ./wiki/tools/Test-Links.ps1 -Book ./wiki/book -MapPath ./wiki/tools/wiki-redirect-map.tsv
+
+    - name: Deploy GitHub Pages
+      run: |
+        cd wiki
         git worktree add gh-pages
         git config user.name "GitHub Pages from CI"
         git config user.email ""
diff --git a/wiki/tools/README.md b/wiki/tools/README.md
new file mode 100644
index 00000000..43c313ac
--- /dev/null
+++ b/wiki/tools/README.md
@@ -0,0 +1,99 @@
+# Wiki Tools
+
+Tooling for the legacy GitHub wiki, which was superseded by
+<https://dotnet.github.io/aspnet-api-versioning>.
+
+The wiki is intentionally kept online rather than disabled. Articles, training material, and
+blog posts link to it, and those links should keep resolving. Every page has been replaced with
+a short stub pointing at the equivalent page on the new site.
+
+## Why stubs instead of redirects
+
+GitHub wikis cannot issue an HTTP redirect. There is no `_redirects` or `.htaccess`, and
+GitHub's Markdown sanitizer strips `<meta http-equiv="refresh">`, `<script>`, and
+`<link rel="canonical">`. A stub page is the only available "soft redirect": it keeps human
+visitors moving to the right place, and search engines derank the thin duplicate pages over
+time. It does not transfer ranking signal the way a 301 would.
+
+## Files
+
+| File | Purpose |
+|:-----|:--------|
+| `wiki-redirect-map.tsv` | Old wiki page &rarr; new site path(s). Tab-separated. |
+| `make-wiki-stubs.ps1`   | Rewrites every wiki page into a stub from that map. |
+| `Test-Links.ps1`        | Validates relative links and anchors in the built site. |
+
+## Link checking
+
+`Test-Links.ps1` runs in CI as the **Check Links** step of `.github/workflows/gh-pages.yml`,
+between the build and the deploy, so a broken link fails the workflow instead of shipping.
+
+mdBook rewrites `.md` links to `.html` but never verifies the target exists &mdash; a link to a
+renamed or deleted page builds cleanly and 404s in production. The script resolves every
+relative `href`/`src` in the generated HTML against the filesystem and checks that each
+`#fragment` matches a real `id` on the target page.
+
+Passing `-MapPath` also verifies every target in `wiki-redirect-map.tsv`. If the site is
+restructured, the build fails with the stale entries listed, rather than the legacy wiki
+quietly pointing at pages that no longer exist.
+
+```powershell
+cd wiki
+mdbook build
+./tools/Test-Links.ps1 -Book ./book -MapPath ./tools/wiki-redirect-map.tsv
+```
+
+It exits non-zero when anything is broken, and reports `MISSING FILE` or `MISSING ANCHOR` per
+link. mdBook's `404.html` is skipped: its links are deliberately site-absolute via `<base href>`
+and cannot be resolved on disk.
+
+## Usage
+
+The wiki is a git repository. Clone it with **full history** &mdash; a shallow clone can be
+rejected on push with `shallow update not allowed`:
+
+```powershell
+git clone https://github.com/dotnet/aspnet-api-versioning.wiki.git
+
+# preview (default: writes nothing)
+./make-wiki-stubs.ps1 -WikiPath ./aspnet-api-versioning.wiki -MapPath ./wiki-redirect-map.tsv
+
+# write the stubs
+./make-wiki-stubs.ps1 -WikiPath ./aspnet-api-versioning.wiki -MapPath ./wiki-redirect-map.tsv -Apply
+```
+
+The script never pushes. Review the diff and push yourself:
+
+```powershell
+cd ./aspnet-api-versioning.wiki
+git diff --stat
+git add -A && git commit -m "Redirect wiki to https://dotnet.github.io/aspnet-api-versioning"
+git push
+```
+
+## Maintaining the map
+
+If the documentation site is restructured, update `wiki-redirect-map.tsv` and re-run the
+script. The map is reconciled against the wiki on every run: pages present in the wiki but
+missing from the map are reported and skipped, and map rows with no matching page are reported
+as stale.
+
+Columns are `OldPage`, `AspNetCorePath`, `AspNetPath`. Use `-` when a topic exists for only one
+platform, and `(root)` to point at the site root. Paths are relative to the site base URL and
+may include a fragment, for example `aspnet-core/docs/odata-options.html#query-options`.
+
+The separator must be a literal tab. An editor that expands tabs to spaces will cause a
+`malformed row` error rather than a silent misfire.
+
+## Previewing a stub
+
+Local Markdown previewers do not use GitHub's sanitizer. To see exactly what the wiki will
+render:
+
+```powershell
+$md = Get-Content -Raw ./aspnet-api-versioning.wiki/Home.md
+$body = @{ text = $md; mode = 'gfm' } | ConvertTo-Json -Compress
+$tmp = [System.IO.Path]::GetTempFileName()
+[System.IO.File]::WriteAllText($tmp, $body, [System.Text.UTF8Encoding]::new($false))
+gh api --method POST /markdown --input $tmp
+```
diff --git a/wiki/tools/Test-Links.ps1 b/wiki/tools/Test-Links.ps1
new file mode 100644
index 00000000..81f53f67
--- /dev/null
+++ b/wiki/tools/Test-Links.ps1
@@ -0,0 +1,142 @@
+<#
+.SYNOPSIS
+Validates relative links and anchors in a built mdBook site, and optionally the
+legacy wiki redirect map.
+
+.DESCRIPTION
+mdBook rewrites .md links to .html but does not verify the target exists, so a link to a
+page that was renamed or removed builds cleanly and 404s in production. This script walks
+the generated HTML, resolves every relative href/src against the filesystem, and verifies
+that any #fragment matches a real id on the target page.
+
+When -MapPath is supplied, it also confirms every target in the wiki redirect map still
+resolves. If the documentation is restructured, this fails the build instead of silently
+leaving the legacy wiki pointing at pages that no longer exist.
+
+Exits 1 when anything is broken so it can gate a deployment.
+
+.PARAMETER Book
+Path to the generated book directory (the mdbook build output).
+
+.PARAMETER MapPath
+Optional path to wiki-redirect-map.tsv. When given, every mapped target is verified.
+
+.EXAMPLE
+  ./Test-Links.ps1 -Book ./wiki/book
+  ./Test-Links.ps1 -Book ./wiki/book -MapPath ./wiki/tools/wiki-redirect-map.tsv
+#>
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)][string]$Book,
+    [string]$MapPath
+)
+
+$ErrorActionPreference = 'Stop'
+
+if (-not (Test-Path -LiteralPath $Book)) { throw "book directory not found: $Book" }
+$Book = (Resolve-Path $Book).Path
+
+$pages = Get-ChildItem -LiteralPath $Book -Recurse -Filter *.html -File
+if (-not $pages) { throw "no HTML found under $Book - did mdbook build run?" }
+
+# --- index every anchor id in the generated site ---------------------------
+$ids = @{}
+foreach ($p in $pages) {
+    $text = Get-Content -Raw -LiteralPath $p.FullName
+    $set = [System.Collections.Generic.HashSet[string]]::new()
+    foreach ($m in [regex]::Matches($text, '\bid="([^"]+)"')) { [void]$set.Add($m.Groups[1].Value) }
+    $ids[$p.FullName.ToLowerInvariant()] = $set
+}
+
+$broken = New-Object System.Collections.Generic.List[object]
+$seen = [System.Collections.Generic.HashSet[string]]::new()
+$checked = 0
+
+foreach ($p in $pages) {
+    $relPage = $p.FullName.Substring($Book.Length).TrimStart('\', '/').Replace('\', '/')
+
+    # mdBook's 404 page is deliberately site-absolute via <base href>; its links
+    # cannot be resolved on disk and are not a defect.
+    if ($relPage -eq '404.html') { continue }
+
+    $text = Get-Content -Raw -LiteralPath $p.FullName
+    foreach ($m in [regex]::Matches($text, '(?:href|src)="([^"]+)"')) {
+        $url = [System.Net.WebUtility]::HtmlDecode($m.Groups[1].Value)
+
+        # relative links only: skip scheme-qualified, protocol-relative,
+        # root-absolute, and same-page anchors
+        if ($url -match '^([a-zA-Z][a-zA-Z0-9+.-]*:|//|/|#)') { continue }
+
+        $parts = $url.Split('#', 2)
+        $path = [System.Uri]::UnescapeDataString($parts[0])
+        $frag = if ($parts.Count -gt 1) { [System.Uri]::UnescapeDataString($parts[1]) } else { '' }
+        if ([string]::IsNullOrEmpty($path)) { continue }
+
+        $checked++
+        $target = [System.IO.Path]::GetFullPath([System.IO.Path]::Combine($p.DirectoryName, $path))
+
+        $why = $null
+        if (-not (Test-Path -LiteralPath $target)) {
+            $why = 'MISSING FILE'
+        } elseif ($frag -and $target.EndsWith('.html')) {
+            $key = $target.ToLowerInvariant()
+            if (-not ($ids.ContainsKey($key) -and $ids[$key].Contains($frag))) { $why = 'MISSING ANCHOR' }
+        }
+
+        if ($why) {
+            $k = "$relPage|$url"
+            if ($seen.Add($k)) { $broken.Add([pscustomobject]@{ Why = $why; Page = $relPage; Url = $url }) }
+        }
+    }
+}
+
+Write-Output "checked $checked relative link(s) across $($pages.Count) page(s)"
+
+# --- validate the legacy wiki redirect map ---------------------------------
+$mapBroken = New-Object System.Collections.Generic.List[object]
+if ($MapPath) {
+    if (-not (Test-Path -LiteralPath $MapPath)) { throw "map not found: $MapPath" }
+    $mapChecked = 0
+    foreach ($line in Get-Content -LiteralPath $MapPath) {
+        if ($line -match '^\s*(#|$)') { continue }
+        $cols = $line -split "`t"
+        if ($cols.Count -lt 2) { throw "malformed row (expected 2-3 tab-separated columns): $line" }
+        $page = $cols[0].Trim()
+        foreach ($t in @($cols[1], $(if ($cols.Count -ge 3) { $cols[2] } else { '-' }))) {
+            $t = $t.Trim()
+            if ($t -eq '-' -or $t -eq '(root)' -or -not $t) { continue }
+            $mapChecked++
+            $file = ($t -split '#', 2)[0]
+            if (-not (Test-Path -LiteralPath (Join-Path $Book $file))) {
+                $mapBroken.Add([pscustomobject]@{ Page = $page; Url = $t })
+            }
+        }
+    }
+    Write-Output "checked $mapChecked wiki redirect target(s)"
+}
+
+# --- report ----------------------------------------------------------------
+$failed = $false
+
+if ($broken.Count -gt 0) {
+    $failed = $true
+    Write-Output ''
+    Write-Output "BROKEN LINKS: $($broken.Count)"
+    foreach ($b in ($broken | Sort-Object Why, Page, Url)) {
+        Write-Output ("  [{0}] {1} -> {2}" -f $b.Why, $b.Page, $b.Url)
+    }
+}
+
+if ($mapBroken.Count -gt 0) {
+    $failed = $true
+    Write-Output ''
+    Write-Output "STALE WIKI REDIRECT TARGETS: $($mapBroken.Count)"
+    Write-Output '  (update wiki-redirect-map.tsv and re-run make-wiki-stubs.ps1)'
+    foreach ($b in $mapBroken) {
+        Write-Output ("  {0} -> {1}" -f $b.Page, $b.Url)
+    }
+}
+
+if ($failed) { exit 1 }
+
+Write-Output 'OK - no broken relative links'
diff --git a/wiki/tools/make-wiki-stubs.ps1 b/wiki/tools/make-wiki-stubs.ps1
new file mode 100644
index 00000000..7c65fb85
--- /dev/null
+++ b/wiki/tools/make-wiki-stubs.ps1
@@ -0,0 +1,149 @@
+<#
+.SYNOPSIS
+Rewrites every page of the legacy GitHub wiki into a short "this page has moved" stub.
+
+.DESCRIPTION
+The documentation moved from the GitHub wiki to https://dotnet.github.io/aspnet-api-versioning.
+GitHub wikis cannot issue HTTP redirects: there is no _redirects or .htaccess, and GitHub's
+sanitizer strips meta-refresh, <script>, and <link rel="canonical">. The next best thing is a
+thin stub per page pointing at the new site, so stale inbound links from articles, training
+material, and blog posts land somewhere useful instead of on stale duplicate content.
+
+The wiki is a git repository, so all pages are rewritten in one pass and pushed as one commit.
+
+Dry run by default. Nothing is written without -Apply, and the script never pushes; it prints
+the git commands for you to run yourself.
+
+.PARAMETER WikiPath
+Path to a clone of https://github.com/dotnet/aspnet-api-versioning.wiki.git. Clone with full
+history - a shallow clone (--depth 1) can be rejected on push with "shallow update not allowed".
+
+.PARAMETER MapPath
+Path to wiki-redirect-map.tsv. Tab-separated; a row whose columns are space-separated instead
+of tab-separated will fail with a "malformed row" error rather than silently misfiring.
+
+.EXAMPLE
+  git clone https://github.com/dotnet/aspnet-api-versioning.wiki.git
+  ./make-wiki-stubs.ps1 -WikiPath ./aspnet-api-versioning.wiki -MapPath ./wiki-redirect-map.tsv
+  ./make-wiki-stubs.ps1 -WikiPath ./aspnet-api-versioning.wiki -MapPath ./wiki-redirect-map.tsv -Apply
+
+.NOTES
+To preview exactly how GitHub will render a stub (its sanitizer differs from local previewers):
+
+  $md = Get-Content -Raw ./aspnet-api-versioning.wiki/Home.md
+  $body = @{ text = $md; mode = 'gfm' } | ConvertTo-Json -Compress
+  $tmp = [System.IO.Path]::GetTempFileName()
+  [System.IO.File]::WriteAllText($tmp, $body, [System.Text.UTF8Encoding]::new($false))
+  gh api --method POST /markdown --input $tmp
+#>
+[CmdletBinding()]
+param(
+    [Parameter(Mandatory = $true)][string]$WikiPath,
+    [Parameter(Mandatory = $true)][string]$MapPath,
+    [string]$BaseUrl = 'https://dotnet.github.io/aspnet-api-versioning',
+    [switch]$Apply
+)
+
+$ErrorActionPreference = 'Stop'
+$BaseUrl = $BaseUrl.TrimEnd('/')
+
+if (-not (Test-Path -LiteralPath $WikiPath)) { throw "wiki path not found: $WikiPath" }
+if (-not (Test-Path -LiteralPath $MapPath))  { throw "map not found: $MapPath" }
+
+# --- load the mapping -------------------------------------------------------
+$map = @{}
+foreach ($line in Get-Content -LiteralPath $MapPath) {
+    if ($line -match '^\s*(#|$)') { continue }
+    $cols = $line -split "`t"
+    if ($cols.Count -lt 2) { throw "malformed row (expected 2-3 tab-separated columns): $line" }
+    $map[$cols[0].Trim()] = @{
+        Core   = $cols[1].Trim()
+        AspNet = if ($cols.Count -ge 3) { $cols[2].Trim() } else { '-' }
+    }
+}
+
+# --- reconcile the map against what is actually in the wiki -----------------
+$pages = Get-ChildItem -LiteralPath $WikiPath -Filter *.md -File | Sort-Object Name
+$onDisk = $pages | ForEach-Object { [System.IO.Path]::GetFileNameWithoutExtension($_.Name) }
+
+$unmapped = $onDisk | Where-Object { -not $map.ContainsKey($_) }
+$stale    = $map.Keys | Where-Object { $_ -notin $onDisk }
+
+if ($unmapped) { Write-Warning "wiki pages with no mapping (will be SKIPPED):`n  $($unmapped -join "`n  ")" }
+if ($stale)    { Write-Warning "mapping rows with no matching wiki page:`n  $($stale -join "`n  ")" }
+
+# --- build the stubs --------------------------------------------------------
+function New-Stub {
+    param([string]$Name, [hashtable]$Target)
+
+    $title = ($Name -replace '-', ' ')
+    $sb = [System.Text.StringBuilder]::new()
+
+    if ($Target.Core -eq '(root)') {
+        [void]$sb.AppendLine("# Moved")
+        [void]$sb.AppendLine()
+        [void]$sb.AppendLine("The documentation has moved to a new site:")
+        [void]$sb.AppendLine()
+        [void]$sb.AppendLine("## [$BaseUrl/]($BaseUrl/)")
+        [void]$sb.AppendLine()
+        [void]$sb.AppendLine("This wiki is no longer maintained.")
+        return $sb.ToString()
+    }
+
+    [void]$sb.AppendLine("# Moved")
+    [void]$sb.AppendLine()
+    [void]$sb.AppendLine("This page has moved to the new documentation site.")
+    [void]$sb.AppendLine()
+
+    $hasCore = $Target.Core -ne '-' -and $Target.Core
+    $hasNet  = $Target.AspNet -ne '-' -and $Target.AspNet
+
+    if ($hasCore -and $hasNet) {
+        [void]$sb.AppendLine("- **ASP.NET Core** &rarr; [$title]($BaseUrl/$($Target.Core))")
+        [void]$sb.AppendLine("- **ASP.NET Web API** &rarr; [$title]($BaseUrl/$($Target.AspNet))")
+    } elseif ($hasCore) {
+        [void]$sb.AppendLine("**[$title]($BaseUrl/$($Target.Core))** (ASP.NET Core)")
+    } elseif ($hasNet) {
+        [void]$sb.AppendLine("**[$title]($BaseUrl/$($Target.AspNet))** (ASP.NET Web API)")
+    } else {
+        throw "no target for $Name"
+    }
+
+    [void]$sb.AppendLine()
+    [void]$sb.AppendLine("---")
+    [void]$sb.AppendLine()
+    [void]$sb.AppendLine("This wiki is no longer maintained. Browse the full documentation at <$BaseUrl/>.")
+    return $sb.ToString()
+}
+
+$written = 0
+foreach ($p in $pages) {
+    $name = [System.IO.Path]::GetFileNameWithoutExtension($p.Name)
+    if (-not $map.ContainsKey($name)) { continue }
+
+    $stub = New-Stub -Name $name -Target $map[$name]
+
+    if ($Apply) {
+        # LF endings, no BOM - matches how GitHub stores wiki content
+        $utf8 = [System.Text.UTF8Encoding]::new($false)
+        [System.IO.File]::WriteAllText($p.FullName, ($stub -replace "`r`n", "`n"), $utf8)
+    } else {
+        Write-Output "--- $($p.Name) ".PadRight(72, '-')
+        Write-Output $stub.TrimEnd()
+        Write-Output ''
+    }
+    $written++
+}
+
+Write-Output ''
+if ($Apply) {
+    Write-Output "rewrote $written page(s) in $WikiPath"
+    Write-Output ''
+    Write-Output 'Review, then push yourself:'
+    Write-Output "  cd $WikiPath"
+    Write-Output '  git diff --stat'
+    Write-Output '  git add -A && git commit -m "Redirect wiki to https://dotnet.github.io/aspnet-api-versioning"'
+    Write-Output '  git push'
+} else {
+    Write-Output "DRY RUN - $written page(s) would be rewritten. Re-run with -Apply to write them."
+}
diff --git a/wiki/tools/wiki-redirect-map.tsv b/wiki/tools/wiki-redirect-map.tsv
new file mode 100644
index 00000000..e33817b1
--- /dev/null
+++ b/wiki/tools/wiki-redirect-map.tsv
@@ -0,0 +1,54 @@
+# Old GitHub wiki page -> new site path(s), relative to https://dotnet.github.io/aspnet-api-versioning/
+# Columns: OldPage <TAB> AspNetCorePath <TAB> AspNetPath
+# Use "-" when a page exists for only one framework. Use "(root)" to point at the site root.
+API-Documentation	aspnet-core/docs/overview.html	aspnet/docs/overview.html
+API-Explorer-Options	aspnet-core/docs/options.html	aspnet/docs/options.html
+API-Version-Conventions	aspnet-core/config/conventions.html	aspnet/config/conventions.html
+API-Version-Reader	aspnet-core/config/reader.html	aspnet/config/reader.html
+API-Version-Selector	aspnet-core/config/selector.html	aspnet/config/selector.html
+API-Versioning-Options	aspnet-core/config/options.html	aspnet/config/options.html
+API-Versioning-with-OData	aspnet-core/odata/overview.html	aspnet/odata/overview.html
+API-Versioning-with-gRPC	aspnet-core/grpc/overview.html	-
+Accessing-Version-Information	aspnet-core/how-to/requested-version.html	aspnet/how-to/requested-version.html
+Configuring-Your-Application	aspnet-core/config/overview.html	aspnet/config/overview.html
+Controller-Conventions	aspnet-core/how-to/naming-conventions.html	aspnet/how-to/naming-conventions.html
+Custom-API-Version-Format	aspnet-core/ext/custom-format.html	aspnet/ext/custom-format.html
+Custom-Attributes	aspnet-core/ext/custom-attributes.html	aspnet/ext/custom-attributes.html
+Defining-a-Service-Version	aspnet-core/how-to/define-service-version.html	aspnet/how-to/define-service-version.html
+Deprecating-a-Service-Version	aspnet-core/how-to/deprecate-version.html	aspnet/how-to/deprecate-version.html
+Error-Responses	aspnet-core/errors.html	aspnet/errors.html
+Existing-Services	aspnet-core/how-to/existing-services.html	aspnet/how-to/existing-services.html
+Existing-Services-Quick-Start	aspnet-core/quick-starts/existing-services.html	aspnet/quick-starts/existing-services.html
+FAQ	aspnet-core/faq.html	aspnet/faq.html
+Home	(root)	-
+How-to-Version-Your-Service	aspnet-core/how-to/overview.html	aspnet/how-to/overview.html
+Known-Limitations	aspnet-core/limitations.html	aspnet/limitations.html
+Migration	aspnet-core/quick-starts/migration.html	aspnet/quick-starts/migration.html
+New-Services-Quick-Start	aspnet-core/quick-starts/new-services.html	aspnet/quick-starts/new-services.html
+OData-Batching	aspnet-core/odata/batching.html	-
+OData-Model-Configurations	aspnet-core/odata/model-config.html	aspnet/odata/model-config.html
+OData-Model-Substitution	aspnet-core/odata/model-substitution.html	aspnet/odata/model-substitution.html
+OData-Protocol-Transitions	-	aspnet/odata/protocol-transition.html
+OData-Query-Options	aspnet-core/docs/odata-options.html#query-options	aspnet/docs/odata-options.html#query-options
+OData-Versioned-Controllers	aspnet-core/odata/controllers.html	aspnet/odata/controllers.html
+OData-Versioned-Metadata	aspnet-core/odata/metadata.html	aspnet/odata/metadata.html
+OpenAPI-Options	aspnet-core/docs/openapi-options.html	-
+Scalar-Integration	aspnet-core/docs/scalar.html	-
+Swashbuckle-Integration	aspnet-core/docs/swashbuckle.html	aspnet/docs/swashbuckle.html
+Third-Party-Extensions	aspnet-core/ext/third-party.html	-
+Version-Advertisement	aspnet-core/how-to/version-advertisement.html	aspnet/how-to/version-advertisement.html
+Version-Discovery	aspnet-core/version-discovery.html	aspnet/version-discovery.html
+Version-Format	aspnet-core/version-format.html	aspnet/version-format.html
+Version-Interleaving	aspnet-core/how-to/version-interleaving.html	aspnet/how-to/version-interleaving.html
+Version-Neutral	aspnet-core/how-to/version-neutral.html	aspnet/how-to/version-neutral.html
+Version-Policies	aspnet-core/version-policies.html	aspnet/version-policies.html
+Versioned-Clients	aspnet-core/ext/clients.html	aspnet/ext/clients.html
+Versioned-ODataModelBuilder	aspnet-core/odata/model-builder.html	aspnet/odata/model-builder.html
+Versioned-Protocol-Buffer-Message-Fields	aspnet-core/grpc/versioned-fields.html	-
+Versioning-by-Header	aspnet-core/how-to/version-by-header.html	aspnet/how-to/version-by-header.html
+Versioning-by-Media-Type	aspnet-core/how-to/version-by-media-type.html	aspnet/how-to/version-by-media-type.html
+Versioning-via-the-Query-String	aspnet-core/how-to/version-by-query-string.html	aspnet/how-to/version-by-query-string.html
+Versioning-via-the-URL-Path	aspnet-core/how-to/version-by-url.html	aspnet/how-to/version-by-url.html
+gRPC-API-Explorer-Options	aspnet-core/docs/grpc-options.html	-
+gRPC-Request-Parameters	aspnet-core/grpc/request-parameters.html	-
+_Sidebar	(root)	-

From da69d29bff786c3229292490e8edd18d9bd88b5c Mon Sep 17 00:00:00 2001
From: Chris Martinez <sydefekt@hotmail.com>
Date: Wed, 5 Aug 2026 21:12:04 -0700
Subject: [PATCH 2/2] Fix the .NET Foundation image and links in the README

---
 README.md | 6 ++++--
 asp.slnx  | 1 +
 dnf.svg   | 1 +
 3 files changed, 6 insertions(+), 2 deletions(-)
 create mode 100644 dnf.svg

diff --git a/README.md b/README.md
index 4c503c3f..2d11796c 100644
--- a/README.md
+++ b/README.md
@@ -1,4 +1,4 @@
-[![.NET Foundation](https://img.shields.io/badge/.NET%20Foundation-blueviolet.svg)](https://dotnetfoundation.org/projects/project-detail/asp.net-api-versioning)
+[![.NET Foundation](https://img.shields.io/badge/.NET%20Foundation-blueviolet.svg)][dnf]
 [![MIT License](https://img.shields.io/github/license/dotnet/aspnet-api-versioning?color=%230b0&style=flat-square)](https://github.com/dotnet/aspnet-api-versioning/blob/main/LICENSE.txt)
 [![Build Status](https://dev.azure.com/aspnet-api-versioning/build/_apis/build/status/dotnet.aspnet-api-versioning?branchName=main)](https://dev.azure.com/aspnet-api-versioning/build/_build/latest?definitionId=1&branchName=main)
 
@@ -153,10 +153,12 @@ This project is licensed under the [MIT](LICENSE.TXT) license.
 
 ## .NET Foundation
 
-[<img align="right" width="100px" style="margin:-70px 0px 0px 0px" src="https://dotnetfoundation.org/img/logo_v4.svg" />](https://dotnetfoundation.org/projects/aspnet-api-versioning)
+[<img align="right" width="100px" style="margin:-70px 0px 0px 0px" src="dnf.svg" />][dnf]
 This project is supported by the [.NET Foundation](https://dotnetfoundation.org).
 
 ----
 > If you are an existing user, please makes sure you review the [release notes](../../releases) between all major and minor package releases.
 
 <div style="text-align:center;margin-top:32px;font-size:small">Logo by <a href="https://sacramento-design.com" target="_blank">Sacramento Design Works</a></div>
+
+[dnf]: https://dotnetfoundation.org/projects/project-detail/asp.net-api-versioning
\ No newline at end of file
diff --git a/asp.slnx b/asp.slnx
index ce62c5a2..a971d0ed 100644
--- a/asp.slnx
+++ b/asp.slnx
@@ -38,6 +38,7 @@
     <File Path=".gitattributes" />
     <File Path=".gitignore" />
     <File Path="azure-pipelines.yml" />
+    <File Path="dnf.svg" />
     <File Path="global.json" />
     <File Path="LICENSE.txt" />
     <File Path="logo.svg" />
diff --git a/dnf.svg b/dnf.svg
new file mode 100644
index 00000000..5ac7d0ae
--- /dev/null
+++ b/dnf.svg
@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" width="400" height="400"><path d="M212 13C120.304 13 44.112 79.356 28.807 166.667c17.626.014 31.91 14.306 31.91 31.935 0 17.637-14.297 31.935-31.935 31.935-.036 0-.07-.003-.107-.003C43.655 318.238 120.025 385 212 385c102.725 0 186-83.275 186-186S314.725 13 212 13" fill="#68217a"/><path d="M152.052 220.588h-19.138l-34.696-52.895c-2.035-3.092-3.444-5.42-4.227-6.986h-.233c.313 3.13.47 7.67.47 13.62v46.26H76.32v-84.184h20.43l33.405 51.25 4.226 6.87h.236c-.313-2.036-.47-5.89-.47-11.566v-46.554h17.906zm69.743 0h-50.487v-84.185h48.55v15.44H190.27v18.727h27.533v15.38H190.27v19.257h31.525zm72.62-68.745h-24.01v68.745h-19.022v-68.745H227.49v-15.44h66.925z" fill="#fff"/><path d="M90.34 245.895c-4.64-.23-9.207 3.485-9.563 8.27-.245 1.52-.225 3.003-.216 4.54-1.192.427-2.866-.602-3.748.4.27 1.058-.71 2.966 1.075 3.05.926.088 2.63-.566 2.76.976-.234 7.514-.008 15.094-.086 22.638.392 1.07-.83 3.777.69 3.683 1.107-.125 3.035.862 3.492-.512v-26.872h9.492c-.235-1.084.725-2.794-.39-3.43-3.064.256-6.183.034-9.268.108-.143-3.1-.034-7.39 3.38-8.724 2.644-1.046 5.58-.64 8.26.044-.252-1.217.88-3.144-.49-3.816-1.797-.253-3.578-.424-5.386-.353zm20.002 11.959c-6.417-.562-12.82 4.324-13.883 10.7-1.487 6.186-.787 13.58 3.853 18.315 5.757 5.275 16.076 4.848 20.705-1.755 3.528-4.878 3.708-11.324 2.354-16.957-1.312-5.695-6.517-10.24-12.444-10.283.18.03-.81-.057-.586-.02zm.015 3.425c4.78-.09 8.782 4.18 9.057 8.833.806 5.09.543 11.255-3.553 14.932-4.65 3.81-13.005 1.884-14.644-4.186-1.638-4.83-1.523-10.405.617-15.056 1.645-3.04 5.12-4.737 8.524-4.525zm21.44-2.639c-1.973-.233-.955 2.288-1.192 3.404.11 6.532-.215 13.154.152 19.622.423 4.033 3.173 7.972 7.41 8.55 4.67.96 9.552-1.15 12.995-4.296 1.35-.065.697 1.994.814 2.775-.037 1.6 2.158.72 3.118.782 1.798.386.824-1.85 1.064-3.002v-27.668c-1.378.277-3.127-.778-4.152.304-.073 7.736-.01 15.48-.03 23.22-3.808 3.044-9.195 5.526-14 3.352-3.532-2.182-3.146-6.933-3.19-10.52v-16.355c-.99.103-2.064-.157-2.99-.166zm48.146-.767c-4.03.198-7.6 2.458-10.578 5.022-.517-1.372.58-3.156-.43-4.227-1.3.315-3.262-.672-3.98.842.36 8.206.052 16.496.154 24.734.21 1.614-.417 4.137.298 5.207 1.268-.195 3.107.854 3.875-.395.018-7.702.003-15.405.008-23.108 3.864-3.08 9.463-5.678 14.255-3.152 3.252 2.157 2.802 6.63 2.934 10.025v16.655c1.377-.278 3.126.777 4.15-.305-.106-7.883.39-15.82-.288-23.668-.695-4.18-4.432-7.774-8.87-7.625a18.538 18.538 0 00-1.528-.004zm41.202-11.809c-1.973-.233-.955 2.288-1.192 3.404-.114 3.408.218 6.946-.148 10.282-1.37.706-2.626-1.148-4.034-1.182-5.99-2.145-13.542.38-16.348 6.295-3.19 6.073-2.884 13.548-.135 19.713 2.193 4.248 7.175 6.67 11.78 5.71 3.38-.504 6.326-2.476 8.808-4.73.53 1.29-.59 3.095.436 4.085 1.32-.34 3.247.638 3.98-.87-.36-8.205-.053-16.494-.155-24.732V246.23c-.993.104-2.066-.156-2.99-.166zm-9.442 15.516c2.815.09 6.143.436 8.25 2.32-.08 6.23.158 12.614-.117 18.746-3.838 3.178-9.672 5.355-14.316 2.586-4.12-3.058-4.126-8.833-3.88-13.468.296-4.643 3.424-9.64 8.417-10.07.544-.084 1.097-.104 1.646-.114zm29.847-3.557c-2.658.18-5.368.633-7.9 1.29.227 1.38-.58 3.016.18 4.158 5.17-1.753 11.272-3.16 16.375-.51 2.09 1.436 2.643 4.222 2.37 6.6-6.512.657-13.907-.042-19.247 4.454-4.76 4.648-2.736 14.017 3.843 15.85 5.128 1.71 10.668-.467 14.68-3.772 1.356-.015.533 2.023.7 2.797-.103 1.166 1.538.247 2.223.678.95.263 2.443.1 1.973-1.227-.167-7.74.367-15.52-.307-23.235-.965-4.332-5.394-6.81-9.567-6.96-1.784-.195-3.55-.207-5.322-.122zm11.044 15.01c-.144 3.22.298 6.58-.24 9.705-3.98 3.288-9.933 5.285-14.792 2.77-3.942-2.557-2.952-9.516 1.588-10.852 4.24-1.825 8.958-1.427 13.444-1.955v.3zm14.24-23.588c-1.973-.233-.955 2.288-1.19 3.403-.19 1.86.347 3.953-.218 5.695-.97.865-2.753-.534-3.46.475-.057 1.188-.465 3.68 1.56 3.178.992-.57 2.494-.063 2.197 1.283-.18 4.42.01 8.88-.123 13.323.172 3.908-.4 8.706 3.06 11.46 3.457 2.792 8.244 1.95 12.227 1.128-.213-1.163.522-2.586-.09-3.568-3.08.97-7.35 1.697-9.635-1.187-2.213-3.337-.99-7.582-1.338-11.287v-11.282h11.07c-.237-1.084.724-2.794-.392-3.43-3.533.258-7.123.033-10.678.108v-9.133c-.992.104-2.065-.155-2.99-.165zm19.471-1.72c-1.63.272-.377 2.63-.768 3.73.233 1.61 3.378.308 4.8.73-.198-1.418.69-3.173-.267-4.372-1.263.232-2.524-.21-3.765-.088zm.767 10.916c-1.973-.233-.955 2.288-1.19 3.404v27.43c1.377-.277 3.126.778 4.15-.304.074-10.116.012-20.243.032-30.363-.993.103-2.066-.157-2.992-.166zm22.92-.768c-6.545-.064-12.283 5.48-12.927 11.83-1.157 6.052-.245 13.218 4.59 17.59 6.127 5.13 16.8 4.04 20.88-3.156 2.954-5.183 3.126-11.584 1.33-17.13-1.648-5.285-6.767-9.2-12.366-9.133-.503-.028-1.005-.01-1.508 0zm1.22 3.406c4.778-.09 8.78 4.18 9.054 8.833.806 5.09.544 11.255-3.553 14.932-4.65 3.81-13.007 1.883-14.646-4.186-1.635-4.832-1.524-10.405.617-15.056 1.647-3.04 5.12-4.736 8.527-4.525zm35.308-3.406c-4.032.197-7.6 2.46-10.577 5.022-.517-1.372.582-3.156-.43-4.227-1.3.315-3.262-.672-3.98.842.36 8.206.052 16.496.154 24.734.212 1.614-.416 4.137.3 5.207 1.267-.195 3.106.854 3.874-.395.02-7.702.004-15.405.01-23.108 3.86-3.08 9.46-5.678 14.25-3.152 3.253 2.156 2.806 6.63 2.937 10.025v16.655c1.377-.278 3.126.777 4.15-.305-.108-7.883.393-15.82-.29-23.668-.688-4.195-4.467-7.79-8.868-7.625-.51-.023-1.02-.023-1.53-.004z" font-size="58.667" letter-spacing="-2.85" fill="#fff"/><path d="M51.282 199.167c0 12.98-10.52 23.5-23.5 23.5s-23.5-10.52-23.5-23.5 10.52-23.5 23.5-23.5 23.5 10.52 23.5 23.5" fill="#cf18fd"/></svg>
\ No newline at end of file