Skip to content

chore: Upgrade website to Docsy 0.15.0 #4586

@markmandel

Description

@markmandel

Summary

Upgrade the Agones website from Docsy v0.14.3 to v0.15.0. This also requires bumping the Hugo version in the build image from 0.152.2 to 0.157.0.

Changes Required

File Change
site/go.mod Bump github.com/google/docsy from v0.14.3v0.15.0
site/go.sum Regenerate via cd site && go mod tidy
build/build-image/Dockerfile Bump HUGO_VER from 0.152.20.157.0

New Features in 0.15.0

  • Agent support (experimental): Generates llms.txt and Markdown page output to help AI tools consume documentation
  • Doc-rooted sites (experimental): Publish docs at the root URL (e.g. /get-started/) instead of under /docs/
  • Enhanced version menu: Supports headings, separators, per-entry page-link behaviour, and kind-specific styling

Breaking Changes to Review

  • Version menu markup: Updated HTML markup and CSS classes; the version menu is no longer hidden on smaller viewports — check any custom CSS or layout overrides targeting the old classes
  • Card shortcode: Arguments now processed with RenderString instead of markdownify — low risk, but verify any card shortcode usage renders correctly
  • Multilingual links: Not applicable (Agones site is English-only)

Acceptance Criteria

  • Update site/go.mod and run cd site && go mod tidy
  • Update HUGO_VER in build/build-image/Dockerfile
  • From the build/ directory, run make site-server and open http://localhost:1313 — verify the site renders correctly
  • Check the version menu renders correctly on desktop and mobile viewports
  • Check any pages using the card shortcode render correctly

Metadata

Metadata

Assignees

No one assigned

    Labels

    area/siteThe website itself - including redirects, styling, search, etcgood first issueThese are great first issues. If you are looking for a place to start, start here!help wantedWe would love help on these issues. Please come help us!kind/featureNew features for Agones

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions