chore: upgrade website to Docsy 0.15.0 by Cloud-Architect-Emma · Pull Request #4593 · agones-dev/agones

Cloud-Architect-Emma · 2026-06-01T01:18:38Z

Upgrades the Agones website from Docsy v0.14.3 to v0.15.0 and bumps the Hugo build image version to match the new requirement.
Changes
site/go.mod : Bump github.com/google/docsy from v0.14.3 to v0.15.0
site/go.sum : Regenerated via cd site && go mod tidy
build/build-image: Dockerfile Bump HUGO_VER from 0.152.2 to 0.157.0
Breaking Changes Reviewed

Version menu markup : no custom CSS or layout overrides targeting the old version menu classes found in the Agones site
Card shortcode : no card shortcode usage found in the site content
Multilingual links : not applicable, Agones site is English-only

New Features in Docsy 0.15.0

Agent support (experimental): generates llms.txt and Markdown page output for AI tools
Doc-rooted sites (experimental): publish docs at root URL
Enhanced version menu: supports headings, separators, per-entry page-link behaviour and kind-specific styling

Testing

cd site && go mod tidy ran successfully with no errors
Site renders correctly
Version menu renders correctly on desktop and mobile viewports
Card shortcode pages render correctly

Closes #4586

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

markmandel · 2026-06-01T01:21:11Z

/gcbrun

Let's see it!

agones-bot · 2026-06-01T02:16:53Z

Build Succeeded 🥳

Build Id: be5294bf-69b4-4be6-a770-10d35ad30baf

The following development artifacts have been built, and will exist for the next 30 days:

image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.59.0-dev-40646e9
image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.59.0-dev-40646e9
image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.59.0-dev-40646e9-linux
image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.59.0-dev-40646e9
image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.59.0-dev-40646e9
image: us-docker.pkg.dev/agones-images/ci/agones-processor:1.59.0-dev-40646e9
Linux C++ SDK (build): agonessdk-1.59.0-dev-40646e9-linux-arch_64.tar.gz
SDK Server: agonessdk-server-1.59.0-dev-40646e9.zip

A preview of the website (the last 30 builds are retained):

https://40646e9-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/4593/head:pr_4593 && git checkout pr_4593
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.59.0-dev-40646e9

Cloud-Architect-Emma · 2026-06-01T02:44:17Z

@markmandel , Please can you review this , all checked passed.

Thanks!

Enables the experimental AI agent support feature to output llms.txt at the site root. Co-authored-by: Gemini <gemini@google.com> Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

Moves the [outputs] block to the bottom of config.toml to prevent it from incorrectly capturing adjacent pygments parameters. Co-authored-by: Gemini <gemini@google.com> Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

Cloud-Architect-Emma · 2026-06-03T01:01:40Z

Hi @markmandel! I just ran it locally via hugo server directly to verify.

Initially, placing the [outputs] block near the top caused a TOML scoping issue where Hugo tried to read the subsequent pygments parameters as output formats. I've safely isolated and moved the [outputs] block to the very bottom of site/config.toml.

It now compiles cleanly without those syntax configuration errors! Once the CI completes the preview deploy, the /llms.txt route will be fully ready for us to test live.

markmandel · 2026-06-03T04:57:36Z

/gcbrun

Since I'm very curious what "JSON" is 😄

agones-bot · 2026-06-03T05:02:45Z

Build Failed 😭

Build Id: 5d23d73a-1ac0-4fa5-8bfa-0539d7b2aae1

Status: FAILURE

To get permission to view the Cloud Build view, join the agones-discuss Google Group.

markmandel · 2026-06-03T05:08:42Z

/gcbrun

I fixed this CI issue!

agones-bot · 2026-06-03T06:10:17Z

Build Failed 😭

Build Id: 7d6347b3-3699-4414-aaad-4bc93210b3fe

Status: FAILURE

To get permission to view the Cloud Build view, join the agones-discuss Google Group.

markmandel · 2026-06-03T15:52:22Z

Interesting - the htmltest is failing:

site/index.html
  target does not exist --- site/index.html --> /site/index.json

We probably don't need the json output anyway (as I was saying).

…chore/upgrade-docsy-0.15.0

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

…-Architect-Emma/agones into chore/upgrade-docsy-0.15.0

Cloud-Architect-Emma · 2026-06-04T02:04:06Z

Thanks for looking into this @markmandel! I've removed the JSON output from the config, you're right that it's not needed and was causing the broken link in htmltest. Hopefully it passes now!

markmandel · 2026-06-04T18:56:55Z

/gcbrun

agones-bot · 2026-06-04T19:28:06Z

Build Failed 😭

Build Id: be121b72-f514-4311-b5c6-1b7a60876057

Status: FAILURE

To get permission to view the Cloud Build view, join the agones-discuss Google Group.

Cloud-Architect-Emma · 2026-06-04T19:34:08Z

Hi @markmandel, I don't have access to the Cloud Build logs. Could you let me know what's failing so I can fix it?

Thanks!

markmandel · 2026-06-04T19:44:38Z

@Cloud-Architect-Emma if you join https://groups.google.com/forum/#!forum/agones-discuss - you get access. Or check the failed github checks.

Having a look, it's the print view -- I thought we ignored the print pages in the htmltest config file but apparently I'm wrong.

Do the print pages render correctly?

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

…-Architect-Emma/agones into chore/upgrade-docsy-0.15.0

Cloud-Architect-Emma · 2026-06-04T21:02:10Z

Hi @markmandel, I've explicitly removed JSON from all output formats in config.toml. Could you run /gcbrun again to check if this fixes the htmltest failure? Thanks!

markmandel · 2026-06-04T21:45:25Z

When you look at the error logs, what makes you think it's an issue with the json output?

markmandel · 2026-06-04T21:59:09Z

/gcbrun

agones-bot · 2026-06-04T22:30:17Z

Build Failed 😭

Build Id: e09f8987-9bec-476a-8b6f-c1b84d54fb8b

Status: FAILURE

To get permission to view the Cloud Build view, join the agones-discuss Google Group.

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

Cloud-Architect-Emma · 2026-06-05T08:11:52Z

Hi @markmandel, looking at cloud error log, the failures are broken image paths in the _print aggregated pages, a known issue with the Docsy print output format when relative image paths change depth. I've removed print from the section outputs to fix the htmltest failures. Could you please run /gcbrun again to verify?

Thank you!

markmandel · 2026-06-05T15:36:16Z

/gcbrun

agones-bot · 2026-06-05T16:35:07Z

Build Succeeded 🥳

Build Id: d4487b20-c3e9-45bf-bccb-adc88390815b

The following development artifacts have been built, and will exist for the next 30 days:

image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.59.0-dev-e50b75f
image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.59.0-dev-e50b75f
image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.59.0-dev-e50b75f-linux
image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.59.0-dev-e50b75f
image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.59.0-dev-e50b75f
image: us-docker.pkg.dev/agones-images/ci/agones-processor:1.59.0-dev-e50b75f
Linux C++ SDK (build): agonessdk-1.59.0-dev-e50b75f-linux-arch_64.tar.gz
SDK Server: agonessdk-server-1.59.0-dev-e50b75f.zip

A preview of the website (the last 30 builds are retained):

https://e50b75f-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/4593/head:pr_4593 && git checkout pr_4593
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.59.0-dev-e50b75f

Cloud-Architect-Emma · 2026-06-05T16:38:02Z

😊 😃 finally 🙌!

markmandel · 2026-06-05T17:21:50Z

https://e50b75f-dot-preview-dot-agones-images.appspot.com/site/llms.txt - works! - although we likely need some kinda of redirect (or maybe we can force the path in apps.yaml) from /llms.txt since I assume that is where AI looks for it.
https://e50b75f-dot-preview-dot-agones-images.appspot.com/site/docs/installation/terraform/gke/index.md - markdown meta links work!

Would need to check, but I think we could edit https://github.com/agones-dev/agones/blob/main/site/app.yaml

to add a

  - url: /llms.txt
    static_files: public/llms.txt

Right above the url: /.* declaration, and I think that would do it. (might want to check the path of where llms.txst is inside that generated public folder to make sure my idea is correct).

Once we have done this, I think we are good to go!

Cloud-Architect-Emma · 2026-06-05T17:25:55Z

Noted. Please can you run run /gcbrun for chore: promote PortPolicyNone feature gate from Beta to Stable
#4602

Cloud-Architect-Emma · 2026-06-05T17:44:22Z

Hi @markmandel, I've added the /llms.txt redirect to app.yaml as suggested. Could you please run /gcbrun on PR #4602 (PortPolicyNone promotion) when you get a chance? need to verify. Thanks!

markmandel · 2026-06-05T18:00:48Z

Hi @markmandel, I've added the /llms.txt redirect to app.yaml as suggested.

I'm not seeing this in the PR 🤔 I may be having a senior moment 😄

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

Cloud-Architect-Emma · 2026-06-06T19:56:06Z

Hi @markmandel, I've fixed the app.yaml formatting , the /llms.txt handler now has correct indentation consistent with the other handlers. Could you please run /gcbrun to verify?

Thanks!

markmandel · 2026-06-06T20:53:52Z

/gcbrun

Let's go! 🤞🏻

markmandel · 2026-06-06T20:54:20Z

/gcbrun

agones-bot · 2026-06-06T21:52:17Z

Build Succeeded 🥳

Build Id: ed88066b-2e50-4a04-bf2f-39acdd76a618

The following development artifacts have been built, and will exist for the next 30 days:

image: us-docker.pkg.dev/agones-images/ci/agones-controller:1.59.0-dev-f3ff120
image: us-docker.pkg.dev/agones-images/ci/agones-extensions:1.59.0-dev-f3ff120
image: us-docker.pkg.dev/agones-images/ci/agones-sdk:1.59.0-dev-f3ff120-linux
image: us-docker.pkg.dev/agones-images/ci/agones-ping:1.59.0-dev-f3ff120
image: us-docker.pkg.dev/agones-images/ci/agones-allocator:1.59.0-dev-f3ff120
image: us-docker.pkg.dev/agones-images/ci/agones-processor:1.59.0-dev-f3ff120
Linux C++ SDK (build): agonessdk-1.59.0-dev-f3ff120-linux-arch_64.tar.gz
SDK Server: agonessdk-server-1.59.0-dev-f3ff120.zip

A preview of the website (the last 30 builds are retained):

https://f3ff120-dot-preview-dot-agones-images.appspot.com/

To install this version:

git fetch https://github.com/googleforgames/agones.git pull/4593/head:pr_4593 && git checkout pr_4593
helm install agones ./install/helm/agones --namespace agones-system --set agones.image.registry=us-docker.pkg.dev/agones-images/ci --set agones.image.tag=1.59.0-dev-f3ff120

Cloud-Architect-Emma · 2026-06-06T21:54:36Z

Hi @markmandel, could you please review and run /gcbrun on PR #4602 (PortPolicyNone promotion) as well.

Thanks!

markmandel · 2026-06-07T00:44:33Z

https://f3ff120-dot-preview-dot-agones-images.appspot.com/llms.txt looks good!

markmandel

Nice work!

Cloud-Architect-Emma · 2026-06-07T01:22:12Z

@markmandel, thanks for your review and guidance. PR #4602 (PortPolicyNone promotion) is still pending review and /gcbrun.

Thanks!

* chore: upgrade website to Docsy 0.15.0 Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> * chore(site): enable Docsy 0.15.0 LLMS output format for home page Enables the experimental AI agent support feature to output llms.txt at the site root. Co-authored-by: Gemini <gemini@google.com> Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> * chore(site): fix TOML block scoping for outputs config Moves the [outputs] block to the bottom of config.toml to prevent it from incorrectly capturing adjacent pygments parameters. Co-authored-by: Gemini <gemini@google.com> Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> * chore(site): fix outputs config per maintainer suggestion Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> * chore(site): explicitly disable JSON output format Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> * chore(site): remove print output to fix broken image paths in htmltest Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> * chore(site): add llms.txt redirect in app.yaml Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> * chore(site): fix llms.txt handler indentation in app.yaml Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> --------- Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com> Co-authored-by: Gemini <gemini@google.com> Co-authored-by: Mark Mandel <mark@compoundtheory.com> Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

chore: upgrade website to Docsy 0.15.0

40646e9

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

github-actions Bot added kind/other size/S labels Jun 1, 2026

Cloud-Architect-Emma mentioned this pull request Jun 1, 2026

chore: Upgrade website to Docsy 0.15.0 #4586

Closed

5 tasks

chore(site): enable Docsy 0.15.0 LLMS output format for home page

733661f

Enables the experimental AI agent support feature to output llms.txt at the site root. Co-authored-by: Gemini <gemini@google.com> Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

markmandel reviewed Jun 2, 2026

View reviewed changes

Comment thread site/config.toml Outdated

markmandel reviewed Jun 3, 2026

View reviewed changes

Comment thread site/config.toml Outdated

Merge branch 'main' into chore/upgrade-docsy-0.15.0

9bbaff1

Cloud-Architect-Emma added 3 commits June 4, 2026 02:28

Merge branch 'main' of https://github.com/googleforgames/agones into …

1292db4

…chore/upgrade-docsy-0.15.0

chore(site): fix outputs config per maintainer suggestion

7508459

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

Merge branch 'chore/upgrade-docsy-0.15.0' of https://github.com/Cloud…

b3630b7

…-Architect-Emma/agones into chore/upgrade-docsy-0.15.0

Merge branch 'main' into chore/upgrade-docsy-0.15.0

73d4fac

Cloud-Architect-Emma added 2 commits June 4, 2026 21:30

chore(site): explicitly disable JSON output format

9882174

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

Merge branch 'chore/upgrade-docsy-0.15.0' of https://github.com/Cloud…

0206969

…-Architect-Emma/agones into chore/upgrade-docsy-0.15.0

chore(site): remove print output to fix broken image paths in htmltest

e50b75f

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

chore(site): add llms.txt redirect in app.yaml

b73e3c5

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

markmandel reviewed Jun 5, 2026

View reviewed changes

Comment thread site/app.yaml Outdated

chore(site): fix llms.txt handler indentation in app.yaml

e7b1cda

Signed-off-by: Cloud-Architect-Emma <emmanuela_prince@yahoo.com>

Merge branch 'main' into chore/upgrade-docsy-0.15.0

f3ff120

markmandel approved these changes Jun 7, 2026

View reviewed changes

markmandel merged commit 8eb501f into agones-dev:main Jun 7, 2026
4 checks passed

Uh oh!

Conversation

Cloud-Architect-Emma commented Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

markmandel commented Jun 1, 2026

Uh oh!

agones-bot commented Jun 1, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 1, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Cloud-Architect-Emma commented Jun 3, 2026

Uh oh!

Uh oh!

markmandel commented Jun 3, 2026

Uh oh!

agones-bot commented Jun 3, 2026

Uh oh!

markmandel commented Jun 3, 2026

Uh oh!

agones-bot commented Jun 3, 2026

Uh oh!

markmandel commented Jun 3, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 4, 2026

Uh oh!

markmandel commented Jun 4, 2026

Uh oh!

agones-bot commented Jun 4, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 4, 2026

Uh oh!

markmandel commented Jun 4, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 4, 2026

Uh oh!

markmandel commented Jun 4, 2026

Uh oh!

markmandel commented Jun 4, 2026

Uh oh!

agones-bot commented Jun 4, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 5, 2026

Uh oh!

markmandel commented Jun 5, 2026

Uh oh!

agones-bot commented Jun 5, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 5, 2026

Uh oh!

markmandel commented Jun 5, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 5, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 5, 2026

Uh oh!

markmandel commented Jun 5, 2026

Uh oh!

Uh oh!

Cloud-Architect-Emma commented Jun 6, 2026

Uh oh!

markmandel commented Jun 6, 2026

Uh oh!

markmandel commented Jun 6, 2026

Uh oh!

agones-bot commented Jun 6, 2026

Uh oh!

Cloud-Architect-Emma commented Jun 6, 2026

Uh oh!

markmandel commented Jun 7, 2026

Uh oh!

markmandel left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Cloud-Architect-Emma commented Jun 7, 2026

Uh oh!

Reviewers

Cloud-Architect-Emma commented Jun 1, 2026 •

edited

Loading

Cloud-Architect-Emma commented Jun 1, 2026 •

edited

Loading