Skip to content

Add doc-rooted site example version, update guidance#2563

Merged
chalin merged 2 commits intogoogle:mainfrom
chalin:chalin-m24-doc-rooted-2026-0201
Feb 17, 2026
Merged

Add doc-rooted site example version, update guidance#2563
chalin merged 2 commits intogoogle:mainfrom
chalin:chalin-m24-doc-rooted-2026-0201

Conversation

@chalin
Copy link
Copy Markdown
Collaborator

@chalin chalin commented Feb 17, 2026


  • Doc-rooted site variant: add config/doc-rooted/permalinks.yaml using Hugo permalinks to publish docs at site root (/)
  • Docs rewrite: replace legacy "docs-only" cascade/type guidance with concise doc-rooted permalinks instructions; add migration note and caution about URL conflicts
  • Version menu enhancements: add section headers (**Versions**, **Variant**), kind: latest / kind: home support, markdownify for bold names, pagelinks: false option, separator validation
  • SCSS: extract td-navbar-dropdown-item-icon mixin; add dropdown-item-home (house icon) and dropdown-item-latest (semi-bold + suffix) styles
  • Build scripts: make Hugo environment configurable via env var; add _hugo-dev-test for template metrics; move --logLevel info to base _hugo script
  • Config restructure: move hugo.yamlconfig/_default/hugo.yaml; inline sites YAML anchor; remove unused archived_version param

@chalin chalin merged commit 601fd46 into google:main Feb 17, 2026
12 checks passed
@chalin chalin deleted the chalin-m24-doc-rooted-2026-0201 branch February 17, 2026 00:42
@chalin chalin added this to the 0.15.0 milestone Feb 17, 2026
@chalin chalin mentioned this pull request Mar 1, 2026
10 tasks
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.

Pages missing in the section index of docs-only sites Top-level section landing pages are always rooted in a docs-only site

1 participant