Skip to content

fix(docs): restore canonical version-picker bootstrap in docfx.json _appFooter#194

Merged
Chris-Wolfgang merged 3 commits into
mainfrom
fix/docfx-restore-version-picker-bootstrap
Jun 29, 2026
Merged

fix(docs): restore canonical version-picker bootstrap in docfx.json _appFooter#194
Chris-Wolfgang merged 3 commits into
mainfrom
fix/docfx-restore-version-picker-bootstrap

Conversation

@Chris-Wolfgang

Copy link
Copy Markdown
Owner

Summary

The _appFooter field in docfx_project/docfx.json got reverted to a bare "Made with DocFX" string at some point. Per reference_docfx_version_picker and the canonical repo-template, the version-picker dropdown is wired only via an inline <script> bootstrap inside _appFooter (DocFX's main.js slot is always an empty export default {} stub). Without the bootstrap, docfx_project/public/version-picker.js never loads, and the deployed docs site has no version-picker UI even though the JS, versions.json, and docs/DOCFX-VERSION-PICKER.md all describe it as wired.

This PR restores the canonical _appFooter string. Identical change going out to 13 affected Wolfgang.* repos as a fleet sweep.

Verification

  • curl -s https://chris-wolfgang.github.io/<repo>/versions/latest/ | grep version-picker returns 0 hits today (broken).
  • After release deploy: should return at least 1 hit (the lazy-loaded <script src=".../public/version-picker.js"> tag injected into <head>).
  • For a local check before release: cd docfx_project && docfx build && grep -l version-picker _site/**/*.html.

Origin

Discovered during Try-Pattern's v0.3.3 Tier-1 maintenance pilot, docs-accuracy audit (PR #217 / sub-issue #128). template-drift-scan on docfx.json across all 30 Wolfgang.* repos showed 13 affected.

🤖 Generated with Claude Code

@Chris-Wolfgang Chris-Wolfgang merged commit 4bc0004 into main Jun 29, 2026
8 checks passed
@Chris-Wolfgang Chris-Wolfgang deleted the fix/docfx-restore-version-picker-bootstrap branch June 29, 2026 16:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant