Skip to content

Upgrade Docsy to the 0.18.0 pre-release and Hugo 0.166.0 - #519

Merged
chalin merged 13 commits into
docsy:mainfrom
chalin:chalin-m24-example-0.18-prerelease-2026-1006
Oct 7, 2026
Merged

chalin merged 13 commits into
docsy:mainfrom
chalin:chalin-m24-example-0.18-prerelease-2026-1006

Conversation

@chalin

@chalin chalin commented Oct 6, 2026 •

Copy link
Copy Markdown
Collaborator
  • Scope:
    • Docsy pinned at its 0.18.0 pre-release under the new github.com/docsy/docsy/theme module path
    • Repository URLs re-pointed at the docsy GitHub organization
    • Hugo updated to Docsy's supported version, with the installer approval
    • Agent support enabled as the user guide recommends: Markdown page versions and an llms.txt per language, exercising the release's new per-page discovery link
    • Dev builds at a localhost baseURL, as Docsy's own, so the link check verifies the site's own links against the build
    • Sample-config comments and front matter corrected where they misdescribed their keys
  • Out of scope: the re-pin to v0.18.0 once tagged, a follow-up PR
  • Audit: every other 0.18.0 guide action was already satisfied on main or doesn't apply to this site
  • Validation:
    • The dev-build output diff traces to the plugin scripts moving under /js/plugins/, Docsy's phone-navbar CSS fix, the org URLs, the Hugo generator tag, the new agent-support outputs, and the baseURL change
    • The sitemap URL set is unchanged
  • Preview(s):

chalin added 6 commits October 6, 2026 19:06
- Tracks Docsy's supported Hugo version for 0.18.0
- Pins the theme at the docsy/docsy main commit 64411422, pending the v0.18.0 tag
- Migrates the import from github.com/google/docsy/theme per the 0.18.0 release post
- Follows the Docsy and docsy-example moves from google/ to docsy/; GitHub redirects the old URLs, so this is cleanup
- Leaves the historical 0.14.0 upgrade report and the link-cache entries as they are
@netlify

netlify Bot commented Oct 6, 2026 •

Copy link
Copy Markdown

✅ Deploy Preview for goldydocs ready!

Name Link
🔨 Latest commit db75ef2
🔍 Latest deploy log https://app.netlify.com/projects/goldydocs/deploys/6ac66f139e455c000835373f
😎 Deploy Preview https://deploy-preview-519--goldydocs.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

To edit notification comments on pull requests, go to your Netlify project configuration.

chalin added 6 commits October 7, 2026 04:49
…ts block

- Completes the agent-support setup the user guide pairs with LLMS, so llms.txt links Markdown versions
- Replaces a comment whose instruction would also have dropped the redirects and llms.txt outputs
- Keeps the site's own absolute links (Markdown alternates, llms.txt, print) inside public/, where the link check verifies them against the build instead of the live site
@chalin
chalin marked this pull request as ready for review October 7, 2026 16:26
@chalin
chalin requested a review from a team October 7, 2026 16:26
@chalin
chalin merged commit 910fd31 into docsy:main Oct 7, 2026
8 checks passed
@chalin
chalin deleted the chalin-m24-example-0.18-prerelease-2026-1006 branch October 7, 2026 16:27
@chalin chalin mentioned this pull request Oct 8, 2026
chalin added a commit that referenced this pull request Oct 8, 2026
- **Scope**:
  - Moves the theme pin from #519's pre-release commit to the `theme/v0.18.0` tag, via `npm run update:docsy:mod`
  - Stamps the site version 0.18.0 (`params.version`, `package.json`), as #497 did for 0.17.0
- **Out of scope**:
  - The post-release `-dev` re-stamp and the example's own tag/deploy (release procedure, after merge)
  - #520, #521 and the deferred `tests/llms.test.mjs` (filed follow-ups)
  - The local `public` snapshot symlink vs Hugo 0.166's Node gate (pre-existing build-layout issue)
- **Validation**:
  - `npm run test` green: online link check without errors, site tests passing
  - `hugo mod graph` lists only `github.com/docsy/docsy/theme@v0.18.0`
  - Built output vs the committed snapshot differs only in the Site info badge and release link, `buildDate`, XML serialization of the normalized sitemaps (URL sets unchanged), and source-map module paths
- **Requires** a `hugo mod npm pack` re-run after the version stamp, or the build warns `npm dependencies are out of sync` (the root `package.json` version feeds the generated workspace's sum); CI re-packs before building, so no workflow change
- **Preview(s)**:
  - https://deploy-preview-522--goldydocs.netlify.app/site/ (the Site info badge and release link)
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