D8 canonical refresh: inline root-redirect HTML, drop template file

.github/workflows/build-all-versions.yaml

@@ -119,20 +119,20 @@ jobs:
             try {
               # Attempt dotnet restore + build; failures are non-fatal because
               # DocFX can still extract metadata from source files.
-              $slnFile = Get-ChildItem -Filter '*.sln' -ErrorAction SilentlyContinue |
+              $slnFile = Get-ChildItem -File -ErrorAction SilentlyContinue | Where-Object { $_.Extension -in '.sln','.slnx' } |
                          Select-Object -First 1
               if ($slnFile) {
                 Write-Host "Restoring $($slnFile.Name)..."
-                dotnet restore $slnFile.FullName 2>&1 | Write-Host
+                dotnet restore $slnFile.FullName 2>&1 | Out-Host
                 Write-Host "Building $($slnFile.Name)..."
-                dotnet build $slnFile.FullName --configuration Release --no-restore 2>&1 | Write-Host
+                dotnet build $slnFile.FullName --configuration Release --no-restore 2>&1 | Out-Host
               }
 
               Write-Host "Running docfx metadata..."
-              docfx metadata docfx_project/docfx.json 2>&1 | Write-Host
+              docfx metadata docfx_project/docfx.json 2>&1 | Out-Host
 
               Write-Host "Running docfx build..."
-              docfx build docfx_project/docfx.json 2>&1 | Write-Host
+              docfx build docfx_project/docfx.json 2>&1 | Out-Host
 
               if (Test-Path 'docfx_project/_site') {
                 $dest = Join-Path $outDir 'versions' $version
@@ -207,7 +207,7 @@ jobs:
 
           Push-Location $latestWorkDir
           try {
-            $slnFile = Get-ChildItem -Filter '*.sln' -ErrorAction SilentlyContinue |
+            $slnFile = Get-ChildItem -File -ErrorAction SilentlyContinue | Where-Object { $_.Extension -in '.sln','.slnx' } |
                        Select-Object -First 1
             if ($slnFile) {
               Write-Host "Restoring $($slnFile.Name)..."
@@ -285,9 +285,22 @@ jobs:
             Sort-Object -Property Major, Minor, Patch, Stable -Descending |
             Select-Object -ExpandProperty Tag
 
+          # Only emit version-picker entries for tags whose docs were actually
+          # built and copied under $outDir/versions/<tag>/. Skipped tags (worktree
+          # add failed, DocFX produced no _site, etc.) would otherwise appear in
+          # versions.json as links to 404s on gh-pages.
+          $versionsDir = Join-Path $outDir 'versions'
+          $builtTags = if (Test-Path $versionsDir) {
+            Get-ChildItem -Path $versionsDir -Directory | Select-Object -ExpandProperty Name
+          } else { @() }
+
           [array]$versions = @([PSCustomObject]@{ version = 'latest'; url = "${base}versions/latest/" })
           foreach ($t in $orderedTags) {
-            $versions += [PSCustomObject]@{ version = $t; url = "${base}versions/$t/" }
+            if ($builtTags -contains $t) {
+              $versions += [PSCustomObject]@{ version = $t; url = "${base}versions/$t/" }
+            } else {
+              Write-Host "::notice::Skipping versions.json entry for $t — no built docs under versions/$t/"
+            }
           }
 
           $versionsJson = ConvertTo-Json -InputObject $versions -Depth 3
@@ -299,10 +312,13 @@ jobs:
 
           Write-Host "Generated versions.json with $($versions.Count) entries: $($versions | ForEach-Object { $_.version })"
 
-      - name: Generate root index.html
-        # Builds index.html from the shared template (.github/version-picker-template.html)
-        # so the page layout is maintained in one place and both this workflow and
-        # docfx.yaml produce identical markup.
+      - name: Generate root index.html (meta-refresh → versions/latest/)
+        # Inline the redirect HTML directly. Only the page title (repo name)
+        # is dynamic; the in-page version picker
+        # (docfx_project/public/version-picker.js) handles version switching
+        # from any docs page, so the root no longer needs a clickable list.
+        # Both this workflow and docfx.yaml use the same inline pattern, so
+        # the produced root index.html is identical regardless of trigger.
         shell: pwsh
         env:
           GITHUB_REPOSITORY: ${{ github.repository }}
@@ -312,33 +328,45 @@ jobs:
           $repoName = ($env:GITHUB_REPOSITORY -split '/')[-1]
           $title    = if ($repoName) { "$repoName Documentation" } else { "Documentation" }
 
-          $versionsJsonPath = Join-Path $outDir 'versions' 'latest' 'versions.json'
-          $versions = Get-Content $versionsJsonPath -Raw | ConvertFrom-Json
-
-          $listItems = foreach ($v in $versions) {
-            $liClass = if ($v.version -eq 'latest') { ' class="latest"' } else { '' }
-            $label   = if ($v.version -eq 'latest') { 'latest (stable)' } else { $v.version }
-            "      <li${liClass}><a href=`"$($v.url)`">$label</a></li>"
-          }
-          $listHtml = $listItems -join "`n"
-
-          $templatePath = '.github/version-picker-template.html'
-          if (-not (Test-Path $templatePath)) {
-            Write-Error "Template file '$templatePath' not found. This file is required."
-            exit 1
-          }
-          $template = Get-Content $templatePath -Raw
-          $html = $template -replace '\{\{TITLE\}\}', $title `
-                            -replace '\{\{VERSION_LIST\}\}', $listHtml
-
+          # Build the HTML as a string array joined with LF. Avoids a
+          # PowerShell here-string whose unindented inner lines would
+          # break the surrounding YAML literal-block scalar (they'd
+          # drop below the block's required indentation and terminate
+          # the scalar prematurely). Use a relative `versions/latest/`
+          # link so it resolves under the GitHub Pages project path
+          # `/<repo>/`.
+          $htmlLines = @(
+            '<!DOCTYPE html>',
+            '<html lang="en">',
+            '<head>',
+            '  <meta charset="UTF-8">',
+            '  <meta name="viewport" content="width=device-width, initial-scale=1.0">',
+            "  <title>$title</title>",
+            '  <meta http-equiv="refresh" content="0; url=versions/latest/">',
+            '  <link rel="canonical" href="versions/latest/">',
+            '  <style>',
+            '    body { font-family: -apple-system, BlinkMacSystemFont, "Segoe UI", Roboto, Helvetica, Arial, sans-serif;',
+            '           background: #1e1e2e; color: #cdd6f4; display: flex; flex-direction: column;',
+            '           align-items: center; justify-content: center; padding: 3rem 1rem; min-height: 100vh; margin: 0; }',
+            '    a { color: #89b4fa; }',
+            '  </style>',
+            "  <script>setTimeout(function(){ window.location.replace('versions/latest/'); }, 0);</script>",
+            '</head>',
+            '<body>',
+            '  <p>Redirecting to the latest documentation&hellip;</p>',
+            '  <noscript><p><a href="versions/latest/">Continue to the latest documentation</a></p></noscript>',
+            '</body>',
+            '</html>'
+          )
+          $html = $htmlLines -join "`n"
           $html | Set-Content -Path (Join-Path $outDir 'index.html') -Encoding utf8NoBOM
-          Write-Host "Generated index.html with $($versions.Count) version link(s)."
+          Write-Host "Generated root index.html (meta-refresh → versions/latest/)."
 
       - name: Deploy all versioned docs to gh-pages at root
         # Publishes the entire all_version_docs/ output directory to gh-pages
         # at the site root.  keep_files: true preserves any other content
         # already present on the branch (CNAME, root assets, etc.).
-        uses: peaceiris/actions-gh-pages@4f9cc6602d3f66b9c108549d475ec49e8ef4d45e  # v4.0.0
+        uses: peaceiris/actions-gh-pages@84c30a85c19949d7eee79c4ff27748b70285e453  # v4.1.0
         with:
           github_token: ${{ secrets.GITHUB_TOKEN }}
           publish_dir: ${{ runner.temp }}/all_version_docs