-
Notifications
You must be signed in to change notification settings - Fork 898
Upgrade Docsy to 0.13.0 and Hugo to 0.152.2 #4395
Copy link
Copy link
Closed
Labels
area/build-toolsDevelopment tooling. I.e. pretty much everything in the `build` directory.Development tooling. I.e. pretty much everything in the `build` directory.area/siteThe website itself - including redirects, styling, search, etcThe website itself - including redirects, styling, search, etckind/featureNew features for AgonesNew features for Agones
Description
Description
The Docsy theme has released version 0.13.0, which includes highly requested features like active Table of Contents (TOC) tracking, accessibility improvements, and better dark mode support. It's not totally necessary to upgrade, but there are some nice things in there that would be useful.
Proposed Changes
- Dependency Updates:
- Update Docsy to
v0.13.0. - Update Hugo to
v0.152.2(required for Docsy 0.13 compatibility). - Update Node.js to LTS 24 (recommended for this release).
- Update Bootstrap to
5.3.8(bundled with Docsy).
- Breaking Changes & UX Fixes:
- Language Menu: Docsy 0.13.0 now shows the language menu in the navbar for all viewport widths and hides it from the sidebar by default. This shouldn't affect us, as we don't show it.
- Alert Shortcodes: The
{{% alert %}}shortcode now processes Markdown differently (passing it to the page renderer). We should verify that existing alerts in our documentation still render correctly.
- New Features to Verify:
- Active TOC Tracking: Ensure the new "On this page" highlighting works correctly with our documentation structure.
- Mobile Navbar: Verify the new scroll indicators for overflowing menus on mobile viewports.
- Dark Mode: Check for any regressions in our custom styling with the new dark mode accessibility fixes.
Additional Context
- Agones Build Tooling: This update will likely require changes to the Docker images used for building the site (specifically updating the Hugo and Node versions).
- Docsy Blog Post: Docsy 0.13.0 Release Report(https://www.docsy.dev/blog/2025/0.13.0/)
- Docsy Upgrade Guide: Upgrade to 0.13.0
Task Checklist
- Update
site/themes/docsysubmodule or npm dependency tov0.13.0. - Update Hugo version in
build/build-image/Dockerfile(or relevant CI config). - Test local site generation with
make site-server. - Verify
{{% alert %}}shortcode rendering across docs. - Audit sidebar/navbar language selector visibility.
- Run
make hugo-testto ensure no broken links or rendering errors.
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
area/build-toolsDevelopment tooling. I.e. pretty much everything in the `build` directory.Development tooling. I.e. pretty much everything in the `build` directory.area/siteThe website itself - including redirects, styling, search, etcThe website itself - including redirects, styling, search, etckind/featureNew features for AgonesNew features for Agones