Skip to content

chore: upgrade website to Docsy 0.16.0 and restore the version lock - #4669

Open
markmandel wants to merge 1 commit into
agones-dev:mainfrom
markmandel:site/docsy-0.16.0
Open

chore: upgrade website to Docsy 0.16.0 and restore the version lock#4669
markmandel wants to merge 1 commit into
agones-dev:mainfrom
markmandel:site/docsy-0.16.0

Conversation

@markmandel

Copy link
Copy Markdown
Member

What type of PR is this?

Uncomment only one /kind <> line, press enter to put that in a new line, and remove leading whitespace from that line:

/kind breaking
/kind bug
/kind cleanup

/kind documentation

/kind feature
/kind hotfix
/kind release

What this PR does / Why we need it:

PR #4593 removed the docsy require block from site/go.mod, leaving the theme unpinned. When Docsy 0.16.0 shipped, site builds floated onto it and broke with:

unknown output format "llms" for kind "home"

Fixes include:

  • pin github.com/google/docsy/theme v0.16.0 in site/go.mod
  • point the module import at github.com/google/docsy/theme and drop the docsy/dependencies import; Bootstrap and Font Awesome now come from npm
  • bump Hugo to 0.164.0 (Docsy 0.16.0 requires extended >= 0.160.1)
  • add a site-deps target running "hugo mod npm pack && npm install", required by both site-server and site-static
  • drop the postcss-cli/autoprefixer installs; Docsy 0.16 only invokes PostCSS for RTL languages or when a postcss.config.* is present
  • add security.allowContent for text/html; Hugo 0.162 denies HTML content files by default and the site has two
  • rename languages.en.languageName to label, deprecated in Hugo 0.158
  • set $navbar-padding-x so the navbar brand lines up with page content; Bootstrap gives .navbar no horizontal padding and our navbar.html override lacks Docsy's inner .container-fluid

Which issue(s) this PR fixes:

N/A

Did you use AI tools in preparing this PR?:

Oh yeah.

Special notes for your reviewer:

This will unblock CI!

PR agones-dev#4593 removed the docsy require block from site/go.mod, leaving the
theme unpinned. When Docsy 0.16.0 shipped, site builds floated onto it
and broke with:

    unknown output format "llms" for kind "home"

Fixes include:

- pin github.com/google/docsy/theme v0.16.0 in site/go.mod
- point the module import at github.com/google/docsy/theme and drop the
  docsy/dependencies import; Bootstrap and Font Awesome now come from npm
- bump Hugo to 0.164.0 (Docsy 0.16.0 requires extended >= 0.160.1)
- add a site-deps target running "hugo mod npm pack && npm install",
  required by both site-server and site-static
- drop the postcss-cli/autoprefixer installs; Docsy 0.16 only invokes
  PostCSS for RTL languages or when a postcss.config.* is present
- add security.allowContent for text/html; Hugo 0.162 denies HTML content
  files by default and the site has two
- rename languages.en.languageName to label, deprecated in Hugo 0.158
- set $navbar-padding-x so the navbar brand lines up with page content;
  Bootstrap gives .navbar no horizontal padding and our navbar.html
  override lacks Docsy's inner .container-fluid

Signed-off-by: Mark Mandel <mark@compoundtheory.com>
@markmandel
markmandel requested a review from a team August 1, 2026 07:00
@github-actions github-actions Bot added kind/documentation Documentation for Agones size/S labels Aug 1, 2026
@markmandel

Copy link
Copy Markdown
Member Author

/gcbrun

@Sivasankaran25

Copy link
Copy Markdown
Collaborator

/gcbrun

1 similar comment
@Sivasankaran25

Copy link
Copy Markdown
Collaborator

/gcbrun

@markmandel

Copy link
Copy Markdown
Member Author

/gcbrun

Let's try again 🤷🏻

..what weird thing is going on with the 1.33 clusters. Not having access to the project is very frustrating 😬 (ping @igooch - please work on the migration! )

@Sivasankaran25

Copy link
Copy Markdown
Collaborator

/gcbrun

1 similar comment
@markmandel

Copy link
Copy Markdown
Member Author

/gcbrun

@markmandel

Copy link
Copy Markdown
Member Author

FUN CONFLICTS

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kind/documentation Documentation for Agones size/S

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants