From 6f3b13c5e9d65225842d06dfe137424d5d651ba7 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Tue, 6 Oct 2026 19:06:45 -0400 Subject: [PATCH 01/13] Update Hugo to 0.166.0 and approve its installer - Tracks Docsy's supported Hugo version for 0.18.0 --- package-lock.json | 8 ++++---- package.json | 10 +++++----- packages/hugoautogen/package.json | 4 ++-- 3 files changed, 11 insertions(+), 11 deletions(-) diff --git a/package-lock.json b/package-lock.json index d6dbabc2c66..545b0abfa5e 100644 --- a/package-lock.json +++ b/package-lock.json @@ -14,7 +14,7 @@ "devDependencies": { "autoprefixer": "10.6.1", "cross-env": "10.1.0", - "hugo-extended": "0.164.0", + "hugo-extended": "0.166.0", "link-cache": "0.6.0", "postcss-cli": "12.0.0", "rtlcss": "4.3.0", @@ -756,9 +756,9 @@ } }, "node_modules/hugo-extended": { - "version": "0.164.0", - "resolved": "https://registry.npmjs.org/hugo-extended/-/hugo-extended-0.164.0.tgz", - "integrity": "sha512-XhUZ9cI5XkC+Jtg6GMS679dVSAY7j/Fyo2BYDzsuqTKiMzDwr+Ylqd9Ndgvm2sUW+6BKzJCGQWdPI8QnKhVMSQ==", + "version": "0.166.0", + "resolved": "https://registry.npmjs.org/hugo-extended/-/hugo-extended-0.166.0.tgz", + "integrity": "sha512-vv0OylKYYQ10RoEc0b2kXup1MOAzI3E7bBW3Znje/4yOB5LDqalDW0+OYHMro6/DkP87St8uwccSbQuZVLZGnA==", "dev": true, "hasInstallScript": true, "license": "MIT", diff --git a/package.json b/package.json index 6a27e10e0f5..c848e9079eb 100644 --- a/package.json +++ b/package.json @@ -17,7 +17,7 @@ "_check:links": "lychee-norm-cache", "_commit:public": "HASH=$(git rev-parse --short main); cd public && git add -A && git commit --allow-empty -m \"Site at $HASH\"", "_diff:check": "git diff --name-only --exit-code", - "_get:docsy": "hugo mod get github.com/google/docsy/theme@v$npm_package_version", + "_get:docsy": "hugo mod get github.com/docsy/docsy/theme@v$npm_package_version", "_hugo-dev": "npm run _hugo -- -e dev --logLevel info -DFE", "_hugo": "hugo --cleanDestinationDir", "_is:clean": "bash -c 'o=$(git status --porcelain -uall) && { echo \"$o\"; [ -z \"$o\" ]; }'", @@ -48,8 +48,8 @@ "test-only": "npm run check:links && npm run test:site", "test:site": "node --test 'tests/**/*.test.mjs'", "test": "npm run test-and-fix", - "update:docsy:main": "hugo mod get -u github.com/google/docsy/theme@main && npm run _update:docsy:post", - "update:docsy:mod": "hugo mod get -u github.com/google/docsy/theme && npm run _update:docsy:post", + "update:docsy:main": "hugo mod get -u github.com/docsy/docsy/theme@main && npm run _update:docsy:post", + "update:docsy:mod": "hugo mod get -u github.com/docsy/docsy/theme && npm run _update:docsy:post", "update:docsy:pack": "hugo mod npm pack && npm pkg set 'name=\"@docsy/hugoautogen\"' private=true --json --prefix packages/hugoautogen && npm install --ignore-scripts", "update:main": "npm run update:packages && npm run update:docsy:main", "update:packages": "npm-check-updates -u -x hugo-extended", @@ -58,7 +58,7 @@ "devDependencies": { "autoprefixer": "10.6.1", "cross-env": "10.1.0", - "hugo-extended": "0.164.0", + "hugo-extended": "0.166.0", "link-cache": "0.6.0", "postcss-cli": "12.0.0", "rtlcss": "4.3.0", @@ -77,7 +77,7 @@ }, "allowScripts": { "@parcel/watcher": false, - "hugo-extended@0.164.0": true + "hugo-extended@0.166.0": true }, "private": true, "prettier": { diff --git a/packages/hugoautogen/package.json b/packages/hugoautogen/package.json index 72ba0b2848d..0953dafb7da 100644 --- a/packages/hugoautogen/package.json +++ b/packages/hugoautogen/package.json @@ -4,6 +4,6 @@ "bootstrap": "5.3.8" }, "name": "@docsy/hugoautogen", - "version": "0.1.0", - "private": true + "private": true, + "version": "0.1.0" } From 074ef93080a1ab9b4c8d9d77c6be875aeb900b8f Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Tue, 6 Oct 2026 19:07:25 -0400 Subject: [PATCH 02/13] Update Docsy to the 0.18.0 pre-release under its new module path - 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 --- go.mod | 4 +++- go.sum | 4 ++-- hugo.yaml | 2 +- 3 files changed, 6 insertions(+), 4 deletions(-) diff --git a/go.mod b/go.mod index 3fab4d22c0c..9404c1bdb92 100644 --- a/go.mod +++ b/go.mod @@ -2,4 +2,6 @@ module github.com/google/docsy-example go 1.12 -require github.com/google/docsy/theme v0.17.1-0.20260831231032-2c44726e7773 // indirect +require ( + github.com/docsy/docsy/theme v0.17.1-0.20261006200131-644114223aa8 // indirect +) diff --git a/go.sum b/go.sum index 4a584a7300b..5a7c03ef2a4 100644 --- a/go.sum +++ b/go.sum @@ -1,2 +1,2 @@ -github.com/google/docsy/theme v0.17.1-0.20260831231032-2c44726e7773 h1:hEh0qXu/KXXh7hobVkqh4jTZUnwh/PbI7FHhqPfS+9U= -github.com/google/docsy/theme v0.17.1-0.20260831231032-2c44726e7773/go.mod h1:NX/JqXCbZBn9Q2Hj7ez9Xeh9z4XcLiwmDYZXhB4RhRM= +github.com/docsy/docsy/theme v0.17.1-0.20261006200131-644114223aa8 h1:mi7ip5ZHhGFwamoSY/l1w7SqnZbJqUUe8taRohVm8VU= +github.com/docsy/docsy/theme v0.17.1-0.20261006200131-644114223aa8/go.mod h1:9SfRupN4s/a/PKbXmDHXYo9L+CQI+sokXbXuOxUR91E= diff --git a/hugo.yaml b/hugo.yaml index 507b6055f3d..b90b093dafc 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -248,5 +248,5 @@ module: extended: true min: 0.160.1 imports: - - path: github.com/google/docsy/theme + - path: github.com/docsy/docsy/theme disable: false From 4b17f92fee39c637bb5684e4126e06a4cee5bfbc Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Tue, 6 Oct 2026 19:08:35 -0400 Subject: [PATCH 03/13] Re-point repository references at the docsy GitHub organization - 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 --- content/en/_index.md | 4 ++-- content/en/about/index.md | 2 +- content/en/docs/_index.md | 2 +- content/en/docs/contribution-guidelines.md | 10 +++++----- content/en/site.md | 2 +- content/fa/_index.md | 4 ++-- content/fa/about/index.md | 2 +- content/fa/docs/_index.md | 2 +- content/no/_index.md | 4 ++-- go.mod | 2 +- hugo.yaml | 6 +++--- lychee.toml | 6 +++--- 12 files changed, 23 insertions(+), 23 deletions(-) diff --git a/content/en/_index.md b/content/en/_index.md index 5bbf687fd5b..c0a27a40137 100644 --- a/content/en/_index.md +++ b/content/en/_index.md @@ -61,10 +61,10 @@ Please follow this space for updates! {{% blocks/feature title="Contributions welcome!" icon="fab fa-github" - url="https://github.com/google/docsy-example" + url="https://github.com/docsy/docsy-example" %}} -We do a [Pull Request](https://github.com/google/docsy-example/pulls) +We do a [Pull Request](https://github.com/docsy/docsy-example/pulls) contributions workflow on **GitHub**. New users are always welcome! {{% /blocks/feature %}} diff --git a/content/en/about/index.md b/content/en/about/index.md index 45f6dba6f95..db7ba6231c5 100644 --- a/content/en/about/index.md +++ b/content/en/about/index.md @@ -19,7 +19,7 @@ menu: { main: { weight: 10 } } {{% blocks/lead color="white" %}} -Goldydocs is a sample site using the [Docsy](https://github.com/google/docsy) +Goldydocs is a sample site using the [Docsy](https://github.com/docsy/docsy) Hugo theme that shows what it can do and provides you with a template site structure. It’s designed for you to clone and edit as much as you like. See the different sections of the documentation and site for more ideas. diff --git a/content/en/docs/_index.md b/content/en/docs/_index.md index 8220807943b..d6d9fbc0f44 100755 --- a/content/en/docs/_index.md +++ b/content/en/docs/_index.md @@ -17,7 +17,7 @@ For large documentation sets we recommend adding content under the headings in this section, though if some or all of them don’t apply to your project feel free to remove them or add your own. For a smaller example, see the [Docsy User Guide](https://docsy.dev/docs/), built from the -[`docsy.dev`](https://github.com/google/docsy/tree/main/docsy.dev) directory of +[`docsy.dev`](https://github.com/docsy/docsy/tree/main/docsy.dev) directory of the Docsy monorepo. Other content such as marketing material, case studies, and community updates diff --git a/content/en/docs/contribution-guidelines.md b/content/en/docs/contribution-guidelines.md index ca2988c50fa..fb92b3dd390 100644 --- a/content/en/docs/contribution-guidelines.md +++ b/content/en/docs/contribution-guidelines.md @@ -23,7 +23,7 @@ the README, or include them in both locations. {{% /pageinfo %}} We use [Hugo](https://gohugo.io/) to format and generate our website, the -[Docsy](https://github.com/google/docsy) theme for styling and site structure, +[Docsy](https://github.com/docsy/docsy) theme for styling and site structure, and [Netlify](https://www.netlify.com/) to manage the deployment of the site. Hugo is an open-source static site generator that provides us with templates, content organisation in a standard directory structure, and a website generation @@ -41,7 +41,7 @@ Here's a quick guide to updating the docs. It assumes you're familiar with the GitHub workflow and you're happy to use the automated preview of your doc updates: -1. Fork the [Goldydocs repo](https://github.com/google/docsy-example) on GitHub. +1. Fork the [Goldydocs repo](https://github.com/docsy/docsy-example) on GitHub. 1. Make your changes and send a pull request (PR). 1. If you're not yet ready for a review, add "WIP" to the PR name to indicate it's a work in progress. (**Don't** add the Hugo property "draft = true" to @@ -78,11 +78,11 @@ work: install Hugo and any other tools you need. You'll need at least **Hugo version 0.146.0** (we recommend using the most recent available version), and it must be the **extended** version, which supports SCSS. -1. Fork the [Goldydocs repo](https://github.com/google/docsy-example) repo into +1. Fork the [Goldydocs repo](https://github.com/docsy/docsy-example) repo into your own project, then create a local copy using `git clone`. ```sh - git clone --branch v0.12.0 --depth 1 https://github.com/google/docsy-example.git + git clone --branch v0.12.0 --depth 1 https://github.com/docsy/docsy-example.git ``` 1. Run `hugo server` in the site root directory. By default your site will be @@ -96,7 +96,7 @@ work: If you've found a problem in the docs, but you're not sure how to fix it yourself, please create an issue in the -[Goldydocs repo](https://github.com/google/docsy-example/issues). You can also +[Goldydocs repo](https://github.com/docsy/docsy-example/issues). You can also create an issue about a specific page by clicking the **Create Issue** button in the top right hand corner of the page. diff --git a/content/en/site.md b/content/en/site.md index 46b8cdb7dd3..15d625c8051 100644 --- a/content/en/site.md +++ b/content/en/site.md @@ -16,4 +16,4 @@ v{{% param version %}} ][version] {{% td/site-build-info/netlify team="docsy-example" %}} -[version]: +[version]: diff --git a/content/fa/_index.md b/content/fa/_index.md index 2fe36b07cd4..c798b43461f 100644 --- a/content/fa/_index.md +++ b/content/fa/_index.md @@ -53,10 +53,10 @@ description: ارزیابی درجه حرارت فرنی — در فضای {{% blocks/feature title="همکاری" icon="fab fa-github" - url="https://github.com/google/docsy-example" + url="https://github.com/docsy/docsy-example" %}} -ما یک فرآیند [پول ریکوئست](https://github.com/google/docsy-example/pulls) در **گیتهاب** داریم. ما همیشه از همکاران جدید +ما یک فرآیند [پول ریکوئست](https://github.com/docsy/docsy-example/pulls) در **گیتهاب** داریم. ما همیشه از همکاران جدید خوشحال می‌شویم. {{% /blocks/feature %}} diff --git a/content/fa/about/index.md b/content/fa/about/index.md index 25957fbdf94..440f3243b54 100644 --- a/content/fa/about/index.md +++ b/content/fa/about/index.md @@ -13,7 +13,7 @@ menu: {main: {weight: 10}} {{% blocks/lead %}} -اسناد گلدی یک نمونه سایت با استفاده از [پوسته‌ی داکسی](https://github.com/google/docsy) و قدرت گرفته از هوگو +اسناد گلدی یک نمونه سایت با استفاده از [پوسته‌ی داکسی](https://github.com/docsy/docsy) و قدرت گرفته از هوگو است که به شما نشان می‌دهد چه ویژگی هایی دارد و یک ساختار کامل برای شما ایجاد کرده است. این سایت برای شما ایجاد شده است که دریافت کنید و هرچقد که می‌خواهید آن را تغییر دهید. برای گرفتن ایده های بیشتر می‌توانید از قسمت های مختلف سایت دیدن کنید. diff --git a/content/fa/docs/_index.md b/content/fa/docs/_index.md index b683cad1235..9f3252c1f29 100755 --- a/content/fa/docs/_index.md +++ b/content/fa/docs/_index.md @@ -14,6 +14,6 @@ menu: این قسمت مجلی است که مستندات کاربران در آن قرار دارد. همه‌ی اطلاعاتی که کاربران شما نیاز به فهمیدن دارند تا به درستی از پروژه شما استفاده کنند. -برای مستندات بزرگتر ما پیشنهاد می‌کنیم مطالب را طبق این مثال قرار دهید. البته ممکن است بعضی از آنها مورد نیاز نباشد. پس در حذف و اضافه کردن مطالب خود راحت باشید. نمونه کوچکتر مستندات داکسی را می‌توانید در [اینجا](https://docsy.dev/docs/) مشاهده کنید که در [مخزن گیتهاب پوسته داکسی](https://github.com/google/docsy/tree/main/docsy.dev) قرار دارد. +برای مستندات بزرگتر ما پیشنهاد می‌کنیم مطالب را طبق این مثال قرار دهید. البته ممکن است بعضی از آنها مورد نیاز نباشد. پس در حذف و اضافه کردن مطالب خود راحت باشید. نمونه کوچکتر مستندات داکسی را می‌توانید در [اینجا](https://docsy.dev/docs/) مشاهده کنید که در [مخزن گیتهاب پوسته داکسی](https://github.com/docsy/docsy/tree/main/docsy.dev) قرار دارد. برای فهمیدن چگونگی استفاده از پوسته داکسی، از [رهنمود‌های پوسته داکسی](https://docsy.dev/docs/) استفاده کنید. همچنین می‌توانید در باره‌ی چگونگی مرتب کردن مستندات خود در [اینجا](https://docsy.dev/docs/best-practices/organizing-content/) بخوانید. diff --git a/content/no/_index.md b/content/no/_index.md index 2d650fbbe46..92b6e300196 100644 --- a/content/no/_index.md +++ b/content/no/_index.md @@ -53,11 +53,11 @@ Følg med her for oppdateringer! {{% blocks/feature title="Bidrag er velkomne!" icon="fab fa-github" - url="https://github.com/google/docsy-example" + url="https://github.com/docsy/docsy-example" %}} Vi bruker -[Pull Request](https://github.com/google/docsy-example/pulls)-arbeidsflyt på +[Pull Request](https://github.com/docsy/docsy-example/pulls)-arbeidsflyt på **GitHub**. Nye brukere er alltid velkomne! {{% /blocks/feature %}} diff --git a/go.mod b/go.mod index 9404c1bdb92..3ea7b964df9 100644 --- a/go.mod +++ b/go.mod @@ -1,4 +1,4 @@ -module github.com/google/docsy-example +module github.com/docsy/docsy-example go 1.12 diff --git a/hugo.yaml b/hugo.yaml index b90b093dafc..e7d2d5a05dc 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -131,10 +131,10 @@ params: version: 0.17.1-dev # Repository configuration (URLs for in-page links to opening issues and suggesting changes) - github_repo: https://github.com/google/docsy-example + github_repo: https://github.com/docsy/docsy-example # An optional link to a related project repo. For example, the sibling repository where your product code lives. - github_project_repo: https://github.com/google/docsy + github_project_repo: https://github.com/docsy/docsy # Specify a value here if your content directory is not in your repo's root directory # github_subdir: "" @@ -223,7 +223,7 @@ params: icon: fa-solid fa-hammer desc: Site build information. - name: GitHub - url: https://github.com/google/docsy + url: https://github.com/docsy/docsy icon: fab fa-github desc: Development takes place here! - name: Slack diff --git a/lychee.toml b/lychee.toml index ba90f3ab86b..780b6597b69 100644 --- a/lychee.toml +++ b/lychee.toml @@ -22,9 +22,9 @@ exclude = [ # Docsy page-meta links '^https?://github\.com/.*?/.*?/(new|edit)/', # view/edit-source links '^https://github\.com/[^/]+/[^/]+/issues/new', # per-page "create issue" feedback links - '^https://github\.com/google/docsy-example/commit/', # per-page provenance links - '^https://github\.com/google/docsy-example/tree/main/content/', # view-source tree links + '^https://github\.com/docsy/docsy-example/commit/', # per-page provenance links + '^https://github\.com/docsy/docsy-example/tree/main/content/', # view-source tree links - '^https://github\.com/google/docsy/releases/v[\d.]+-dev', # non-existent -dev releases + '^https://github\.com/docsy/docsy/releases/v[\d.]+-dev', # non-existent -dev releases '^https://github\.com/USERNAME/REPOSITORY', # user guide placeholder repo ] From 2e6c62d36afab91d6a1468d7e5d7e0db7a074d23 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Tue, 6 Oct 2026 19:08:35 -0400 Subject: [PATCH 04/13] Mirror the Docsy pre-release pin in the site version --- package.json | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/package.json b/package.json index c848e9079eb..cfd06ebf8be 100644 --- a/package.json +++ b/package.json @@ -1,12 +1,12 @@ { "name": "docsy-example-site", - "version": "0.17.1-dev+006-over-main-2c44726e", + "version": "0.17.1-dev+060-over-main-64411422", "description": "Example site that uses Docsy theme for technical documentation.", - "repository": "github:google/docsy-example", + "repository": "github:docsy/docsy-example", "homepage": "https://example.docsy.dev", "author": "Docsy Authors", "license": "Apache-2.0", - "bugs": "https://github.com/google/docsy-example/issues", + "bugs": "https://github.com/docsy/docsy-example/issues", "spelling": "cSpell:ignore docsy hugo rtlcss -", "workspaces": [ "packages/hugoautogen" From 3ed201ec30240fe0e0d85821ff176f29b7c7dadc Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Tue, 6 Oct 2026 19:10:21 -0400 Subject: [PATCH 05/13] Sync the lockfile with the site version --- package-lock.json | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/package-lock.json b/package-lock.json index 545b0abfa5e..46b6e2ecd6f 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "docsy-example-site", - "version": "0.17.1-dev+006-over-main-2c44726e", + "version": "0.17.1-dev+060-over-main-64411422", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "docsy-example-site", - "version": "0.17.1-dev+006-over-main-2c44726e", + "version": "0.17.1-dev+060-over-main-64411422", "license": "Apache-2.0", "workspaces": [ "packages/hugoautogen" From 827189cbd78abfe7974e97e4fe5028f09fe41dd3 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Tue, 6 Oct 2026 19:10:21 -0400 Subject: [PATCH 06/13] Link cache: add the docsy-org URLs --- link-cache.jsonc | 25 +++++++++++++++++++++++++ 1 file changed, 25 insertions(+) diff --git a/link-cache.jsonc b/link-cache.jsonc index c98908566a7..5b2b559e731 100644 --- a/link-cache.jsonc +++ b/link-cache.jsonc @@ -349,6 +349,31 @@ "when": "2026-06-29T20:57:57Z", "via": "lychee", }, + "https://github.com/docsy/docsy": { + "result": 200, + "when": "2026-10-06T23:08:57Z", + "via": "lychee", + }, + "https://github.com/docsy/docsy-example": { + "result": 200, + "when": "2026-10-06T23:08:57Z", + "via": "lychee", + }, + "https://github.com/docsy/docsy-example/issues": { + "result": 200, + "when": "2026-10-06T23:08:57Z", + "via": "lychee", + }, + "https://github.com/docsy/docsy-example/pulls": { + "result": 200, + "when": "2026-10-06T23:08:57Z", + "via": "lychee", + }, + "https://github.com/docsy/docsy/tree/main/docsy.dev": { + "result": 200, + "when": "2026-10-06T23:08:57Z", + "via": "lychee", + }, "https://github.com/google/docsy": { "result": 200, "when": "2026-06-29T20:57:56Z", From 5e426511975711d0e2addea3ccde68cbe4948345 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Tue, 6 Oct 2026 21:54:51 -0400 Subject: [PATCH 07/13] Contribution guidelines: drop a doubled word --- content/en/docs/contribution-guidelines.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/en/docs/contribution-guidelines.md b/content/en/docs/contribution-guidelines.md index fb92b3dd390..a4072148902 100644 --- a/content/en/docs/contribution-guidelines.md +++ b/content/en/docs/contribution-guidelines.md @@ -78,8 +78,8 @@ work: install Hugo and any other tools you need. You'll need at least **Hugo version 0.146.0** (we recommend using the most recent available version), and it must be the **extended** version, which supports SCSS. -1. Fork the [Goldydocs repo](https://github.com/docsy/docsy-example) repo into - your own project, then create a local copy using `git clone`. +1. Fork the [Goldydocs repo](https://github.com/docsy/docsy-example) into your + own project, then create a local copy using `git clone`. ```sh git clone --branch v0.12.0 --depth 1 https://github.com/docsy/docsy-example.git From 765ceb810b139ab2e433e7adbdd96c1456500c7e Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Wed, 7 Oct 2026 04:49:59 -0400 Subject: [PATCH 08/13] Site config: correct two enablement comments to match their keys --- hugo.yaml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/hugo.yaml b/hugo.yaml index e7d2d5a05dc..2af908e02fe 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -15,7 +15,7 @@ enableRobotsTXT: true # Will give values to .Lastmod etc. enableGitInfo: true -# Comment out to disable taxonomies in Docsy +# Uncomment to disable taxonomies in Docsy # disableKinds: [taxonomy] # You can add your own taxonomies @@ -139,8 +139,8 @@ params: # Specify a value here if your content directory is not in your repo's root directory # github_subdir: "" - # Uncomment this if your GitHub repo does not have "main" as the default branch, - # or specify a new value if you want to reference another branch in your GitHub links + # Change this if your GitHub repo does not have "main" as the default branch, + # or if you want to reference another branch in your GitHub links github_branch: main # Google Custom Search Engine ID. Remove or comment out to disable search. From 6d4081dedbbed1f7ce661a1f4e2e50ad0c7cfd30 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Wed, 7 Oct 2026 07:28:49 -0400 Subject: [PATCH 09/13] Publish llms.txt for each site language --- hugo.yaml | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/hugo.yaml b/hugo.yaml index 2af908e02fe..fb2f8390fe3 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -97,7 +97,7 @@ markup: # Comment out if you don't want the "print entire section" link enabled. outputs: - home: [HTML, print, RSS, redirects] + home: [HTML, print, RSS, redirects, LLMS] section: [HTML, print, RSS] params: From dc54a3bc5644fc299f4b3853abebe0710c674177 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Wed, 7 Oct 2026 12:09:39 -0400 Subject: [PATCH 10/13] Publish Markdown page versions alongside llms.txt; describe the outputs 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 --- hugo.yaml | 14 +++++++++----- 1 file changed, 9 insertions(+), 5 deletions(-) diff --git a/hugo.yaml b/hugo.yaml index fb2f8390fe3..bcbe7d1579e 100644 --- a/hugo.yaml +++ b/hugo.yaml @@ -93,12 +93,16 @@ markup: # Uncomment if you want your chosen highlight style used for code blocks without a specified language # guessSyntax: true -# Everything below this are Site Params - -# Comment out if you don't want the "print entire section" link enabled. +# Output formats per page kind, beyond HTML. Remove `print` to drop the "print +# entire section" link; `redirects` writes the Netlify `_redirects` file; +# `markdown` and `LLMS` are Docsy's agent support (Markdown page versions and a +# per-site llms.txt), see https://www.docsy.dev/docs/content/agent-support/. outputs: - home: [HTML, print, RSS, redirects, LLMS] - section: [HTML, print, RSS] + home: [HTML, print, RSS, redirects, markdown, LLMS] + page: [HTML, markdown] + section: [HTML, print, RSS, markdown] + +# Everything below this are Site Params params: taxonomy: From 3db969d9d1f063ad6b38cbdea38f96980f8e91f7 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Wed, 7 Oct 2026 12:09:39 -0400 Subject: [PATCH 11/13] Build dev output at a localhost baseURL, as Docsy does - 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 --- package.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/package.json b/package.json index cfd06ebf8be..ba13c8f1b14 100644 --- a/package.json +++ b/package.json @@ -28,7 +28,7 @@ "approve:hugo": "npm run install:safe && npm approve-scripts --allow-scripts-pin hugo-extended && npm run update:docsy:pack", "build:preview": "npm run _hugo-dev -- --minify --baseURL \"${DEPLOY_PRIME_URL:-/}\"", "build:production": "npm run _hugo -- --minify", - "build": "npm run _build -- ", + "build": "cross-env npm run _build -- --baseURL \"${BASE_URL:-http://localhost}\"", "check:links:internal": "npm run build && npm run _check:links -- --offline", "check:links": "npm run build && npm run _check:links --", "ci:prepare": "npm run _get:docsy && hugo mod graph && hugo mod tidy", From dbbcd23a5cff6d557e315384e8e00ccb23e5a20e Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Wed, 7 Oct 2026 12:09:39 -0400 Subject: [PATCH 12/13] Site info page: fix the linkTitle key --- content/en/site.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/en/site.md b/content/en/site.md index 15d625c8051..37e9dbf9e04 100644 --- a/content/en/site.md +++ b/content/en/site.md @@ -1,6 +1,6 @@ --- title: Website information -likeTitle: Site info +linkTitle: Site info description: Information about the website. type: docs params: From db75ef2c511fcc3de475c17e12ffad64139c1cc6 Mon Sep 17 00:00:00 2001 From: Patrice Chalin Date: Wed, 7 Oct 2026 12:09:39 -0400 Subject: [PATCH 13/13] Lychee config: realign the comment columns --- lychee.toml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/lychee.toml b/lychee.toml index 780b6597b69..077a1590639 100644 --- a/lychee.toml +++ b/lychee.toml @@ -22,9 +22,9 @@ exclude = [ # Docsy page-meta links '^https?://github\.com/.*?/.*?/(new|edit)/', # view/edit-source links '^https://github\.com/[^/]+/[^/]+/issues/new', # per-page "create issue" feedback links - '^https://github\.com/docsy/docsy-example/commit/', # per-page provenance links - '^https://github\.com/docsy/docsy-example/tree/main/content/', # view-source tree links + '^https://github\.com/docsy/docsy-example/commit/', # per-page provenance links + '^https://github\.com/docsy/docsy-example/tree/main/content/', # view-source tree links - '^https://github\.com/docsy/docsy/releases/v[\d.]+-dev', # non-existent -dev releases + '^https://github\.com/docsy/docsy/releases/v[\d.]+-dev', # non-existent -dev releases '^https://github\.com/USERNAME/REPOSITORY', # user guide placeholder repo ]