Release 0.15.0 preparation

[chalin]

Issues/PRs in scope

• Update [official-support] link in README.md - Set version to 0.14.2-dev-001-over-main-20ff86e7, and more #2542
• See 0.15.0 milestone
• Add support for agent-friendly content generation #2596
• ...

Fixed issues: Resolved 0.15.0 issues.

Release-prep checklist

For the complete instruction set, see Publishing a release:

• Update Changelog: for inspiration, go over changes since last release v0.14.0...main
• Update the Docsy version in package.json and docsy.dev/hugo.yaml
• Test pre-release from branch
• Pre-release patches?
• Create and push new version tag
• Create and publish the new release 🎉

Docsy example followup (tracked separately):

• https://github.com/google/docsy-example/pull/xxx

Other / related

• v0.14.0...main
• Release 0.14.0 - 0.14.3 preparation #2404
• List of most-upvoted issues

[chalin]

Mid-release report for February

Being a report for February, this covers the release of 0.14.x and initial 0.15.0 work.

Activity summary

• Overall scope (February 1-28, 2026): the PR snapshot below (gh search prs --updated) contains 98 updated
  PRs in Google repos: 86 in google/docsy and 12 in google/docsy-example.

• Releases and release reports

  • Released Docsy v0.14.0 (2026-02-10) to v0.14.3 (2026-02-17).
  • Published and iterated the release communications:
    • Release 0.14.0 report and upgrade guide
    • Hugo 0.152.0 to 0.155.x breaking and notable changes
  • Kept docsy-example aligned with Docsy releases

• Version menu and release process

  • Introduced and documented an improved release process and branch model,
    where deploy/prod is now the deployment branch replacing the old release
    branch flow. For details, see Git repo info and branch model.
  • The docsy.dev site now has a version menu so that readers can access the
    Next version of the site docs. This work included improvements to the
    version partial and version menu behavior.

• Doc-rooted site support and live example

  • Support for doc-rooted (formerly also known as "docs-only") has been broken
    for a while. The feature is now fixed; for a live example, built from the Docsy
    site itself, see
    doc-rooted--docsydocs.netlify.app
  • For details, see Doc-rooted sites.
  • Also see footer and community links section below.

• Localization support

  • Simplified i18n files: dropping unnecessary singular/plural/other form
    syntax, and converted to YAML.
  • Added alert labels, and addressed some locale correctness issues.
  • Added new translations.
  • Also see footer and community links section below.

• Footer and community links

  • Fixed the rendering of footer and community link paths so that they work
    correctly for multilingual sites and any permalinks scheme, including
    doc-rooted sites.

• AGENTS and project docs

  • Added AGENTS.md guidance and reorganized project docs under the project
    section, then refined docs/process guidance through the month.
  • Updated project pages and documentation.

• Other notable activity

  • Continued docs-site UX polish: ToC/sidebar behavior, navbar and hero/cover
    layout tuning, console block UX, and dependency/Hugo updates.

GitHub activity summary:

• Authored: 71 PRs; opened 11 issues (created in February 2026), see
  https://github.com/search?q=org:google+author:chalin+created:2026-02-01..2026-02-28
• Reviewed: 13 PRs, see
  https://github.com/chalin?from=2026-02-01\&to=2026-02-28

Themed activity summaries

Themed activity summaries

Navbar

• Refactored navbar variables/link styling and anchor semantics for CTA links (Refactor navbar vars, anchors, and cover styles; update blog & CL #2509, Centralize btn-lg helper to Hugo params, use anchors not buttons #2517).
• Added opt-in dark navbar link contrast via homepage body_class (Opt-in dark navbar link contrast via homepage body_class #2519).
• Adjusted navbar heights and main-container alignment across breakpoints (Adjust navbar heights and main-container layout #2528).
• Promoted the Examples page in top navigation and aligned related homepage flow (Promote examples page to navbar, rework CTA, hero images, and more #2530, Add cards with thumbnails to examples page, upgrade Hugo to 0.155.3 #2531).
• Added and documented td-navbar-links-all-active, then applied it in docsy-example (Add td-navbar-links-all-active to list of experimental styles in 0.14.0 blog post #2520, Update Docsy to v0.13.1-0.20260206173603 and use td-navbar-links-all-active for homepage docsy-example#414).

Sidebar

• Fixed ToC/sidebar positioning issues on desktop and tablet layouts (Fix toc position on desktop, and left sidenav + main layout on tablet #2525, Adjust ToC and main layout breakpoints under td-no-left-sidebar #2515).
• Factored sidebar-ToC styles and corrected xl ToC sidebar width (Factor sidebar-toc styles, and 0.13.0 + 0.14.0 blog post improvements #2527, Fix ToC sidebar width in xl viewports #2538).
• Scoped .td-main flex behavior to sidebar layouts and fixed vertical growth of .td-main > .row (Apply .td-main flex only when sidebar exists #2546, fix(layout): ensure .td-main > .row grows vertically #2562).
• Updated docs guidance around sidebar_root_for usage in doc-rooted setups (chore(UG): remove sidebar_root_for and add note about creating test pages instead #2567).

Hero/cover

• Reworked homepage CTA and hero imagery as part of examples-page navigation refresh (Promote examples page to navbar, rework CTA, hero images, and more #2530).
• Added cover CTA/layout style refinements (Add extra styles for cover CTA/layouts and update 0.14.0 blog post #2514).
• Refactored cover styles and switched CTA interactions toward anchor-based patterns (Refactor navbar vars, anchors, and cover styles; update blog & CL #2509, Centralize btn-lg helper to Hugo params, use anchors not buttons #2517).
• Added overlay styling for GCS modal used with cover interactions (Add dark overlay styles for GCS modal #2524).
• Improved examples/cover-adjacent visual assets (local card images and thumbnails) (Refresh refache, fix links, add local card images, and more #2518, Add cards with thumbnails to examples page, upgrade Hugo to 0.155.3 #2531).

Release process and branching

• Documented deploy/prod as the production deployment branch replacing release (Document new deploy/prod branch, replacing release #2559).
• Clarified release branch model and branch ancestry links (Clarify release process and branch model #2572, chore: links release and deploy/prod back into main ancestry #2574, Record ancestry with release and deploy/prod #2577).
• Synced release and deploy/prod and updated deployment tracking to 0.14.3 (Update deploy/prod to 0.14.3 #2571, chore: sync release and deploy/prod branches #2573).

Versioning and menus

• Added site version menu support and improved the version partial (Add version menu to site, improve version partial, and more #2557).
• Maintained release-train version bumps for Docsy and docsy-example (Set version to 0.14.3-dev #2555, Release 0.14.3 preparation #2569, Release 0.14.2 preparation docsy-example#421, add i18n message of Chinese (zh) for print support #424, Sidebar tree show only 50 links #426).
• Updated supported-version docs/context for examples alignment (Set version to 0.14.2-dev-001-over-main-20ff86e7, and more #2542, Update supported Docsy vers for main examples, and other misc changes #2543).

Doc-rooted support

• Added doc-rooted example version support and usage guidance (Add doc-rooted site example version, update guidance #2563).
• Introduced TD_BUILD_CTX handling for doc-rooted builds (Use TD_BUILD_CTX for doc-rooted builds #2564).
• Fixed doc-rooted mount/config edge cases including root index clashes and homepage dedup (Update doc-rooted configs to avoid root index render clash, and more #2565, Doc-rooted mounts and more #2566, Dedup site homepages for doc-rooted sites #2568).

Footer and link behavior

• Fixed community/footer links to open new targets only for external URLs and support rel attributes (fix(footer/community-links): only open in new target for external links, support rel for footer #2576).
• Resolved community/footer link path handling under varied permalink schemes (Resolve community and footer links paths under any permalinks scheme #2580).
• Normalized deployment/docs links and canonicalized contributing links (chore(docs): reorg deployment section, normalize links #2556, chore(UG): use canonical URL to contributing page and simplify aliases #2579).

Localization (i18n)

• Converted remaining i18n files from TOML to YAML and removed obsolete TOML files (Convert i18n/uk.toml to .yaml #2454, Delete i18n/uk.toml since we have a .yaml format now #2455, Convert Bengali translations from TOML to YAML #2458, Convert Chinese i18n files from TOML to YAML #2461, Convert Japanese translations from TOML to YAML #2463, Convert Hebrew translation file to YAML #2466, Convert all remaining i18n files to YAML, add helper scripts #2468).
• Expanded translated alert/ToC labels across locales (for example bn, zh-cn/zh-tw, ja, he) (Add alert labels to selected i18n files #2450, Add Bengali translations for alert labels #2459, Add alert label translations for zh-cn and zh-tw #2462, Add alert labels and all-rights-reserved in Japanese #2464, Add alert and table of contents labels to Hebrew i18n #2467).
• Applied locale correctness cleanup in follow-up fixes (Fix grammatical error in Norwegian translation #2498, Replace bogus placeholder locale by fr #2558).

Docs process and maintainer UX

• Added AGENTS.md and reorganized project docs structure (Add AGENTS.md, move a few project pages to be under About section #2446, chore: Rename 'site' docs section to 'project' and update links, and add task plan #2445).
• Added project/site build process documentation and deployment guidance updates (Add site build info and project build documentation #2444, chore(docs): reorg deployment section, normalize links #2556, Document new deploy/prod branch, replacing release #2559).
• Continued maintainer/contributor docs cleanup and canonical-link updates (Update blog and CL for 0.14.2, refactor contrib pages #2550, chore(about): format and add link to project section #2575, chore(UG): use canonical URL to contributing page and simplify aliases #2579).

Build, tooling, and dependency housekeeping

• Updated Hugo/npm dependencies in Docsy and docsy-example (Update NPM packages, Hugo to 0.155.2 #2511, Add cards with thumbnails to examples page, upgrade Hugo to 0.155.3 #2531, Update NPM packages, Hugo to 0.155.2 docsy-example#411).
• Refined package version logic and release/version metadata handling (Adjust pkg version logic splitting out build metadata, and tweak footer icons #2547, Set version to 0.14.3-dev #2555).
• Added markdown lint/check coverage for docsy.dev external URLs (chore: add mdl rule to enable no-docsy-dev-external-urls checking, fix link #2584).

PR list

PR list

The list below was generated with the following command:

$ gh search prs --author chalin --updated 2026-02-01..2026-02-28 --limit 500 --owner google

Showing 98 of 98 pull requests

REPO                  ID     TITLE                                                                                                  LABELS                             UPDATED
google/docsy          #2584  chore: add mdl rule to enable no-docsy-dev-external-urls checking, fix link                            cleanup/refactoring                about 14 hours ago
google/docsy          #2580  Resolve community and footer links paths under any permalinks scheme                                                                      about 10 days ago
google/docsy          #2579  chore(UG): use canonical URL to contributing page and simplify aliases                                 user guide, cleanup/refactoring    about 10 days ago
google/docsy          #2577  Record ancestry with release and deploy/prod                                                                                              about 10 days ago
google/docsy          #2576  fix(footer/community-links): only open in new target for external links, support rel for footer                                           about 11 days ago
google/docsy          #2575  chore(about): format and add link to project section                                                                                      about 11 days ago
google/docsy          #2574  chore: links release and deploy/prod back into main ancestry                                                                              about 11 days ago
google/docsy          #2573  chore: sync release and deploy/prod branches                                                                                              about 11 days ago
google/docsy          #2572  Clarify release process and branch model                                                                                                  about 11 days ago
google/docsy          #2571  Update deploy/prod to 0.14.3                                                                                                              about 11 days ago
google/docsy-example  #426   Set version to 0.14.4-dev                                                                                                                 about 11 days ago
google/docsy-example  #424   Release 0.14.3 preparation                                                                                                                about 11 days ago
google/docsy          #2569  Release 0.14.3 preparation                                                                                                                about 11 days ago
google/docsy          #2568  Dedup site homepages for doc-rooted sites                                                                                                 about 11 days ago
google/docsy          #2567  chore(UG): remove sidebar_root_for and add note about creating test pages instead                      user guide, cleanup/refactoring    about 11 days ago
google/docsy          #2566  Doc-rooted mounts and more                                                                                                                about 12 days ago
google/docsy          #2565  Update doc-rooted configs to avoid root index render clash, and more                                                                      about 12 days ago
google/docsy          #2564  Use TD_BUILD_CTX for doc-rooted builds                                                                                                    about 11 days ago
google/docsy          #2563  Add doc-rooted site example version, update guidance                                                                                      about 12 days ago
google/docsy          #2562  fix(layout): ensure `.td-main > .row` grows vertically                                                 design/style                       about 11 days ago
google/docsy          #2560  Update bug report template                                                                             admin                              about 11 days ago
google/docsy          #2559  Document new `deploy/prod` branch, replacing `release`                                                 CI/infra                           about 11 days ago
google/docsy          #2558  Replace bogus placeholder locale by fr                                                                                                    about 14 days ago
google/docsy          #2557  Add version menu to site, improve version partial, and more                                            user guide                         about 14 days ago
google/docsy          #2556  chore(docs): reorg deployment section, normalize links                                                 cleanup/refactoring                about 14 days ago
google/docsy          #2555  Set version to 0.14.3-dev                                                                                                                 about 14 days ago
google/docsy-example  #421   Release 0.14.2 preparation                                                                                                                about 16 days ago
google/docsy          #2551  Release 0.14.2 preparation                                                                                                                about 16 days ago
google/docsy          #2550  Update blog and CL for 0.14.2, refactor contrib pages                                                                                     about 16 days ago
google/docsy          #2549  Add name attribute to search input                                                                                                        about 16 days ago
google/docsy          #2548  Console code blocks: output is no longer selectable; and code style changes                                                               about 16 days ago
google/docsy          #2547  Adjust pkg version logic splitting out build metadata, and tweak footer icons                          CI/infra                           about 11 days ago
google/docsy          #2546  Apply .td-main flex only when sidebar exists                                                                                              about 17 days ago
google/docsy          #2543  Update supported Docsy vers for main examples, and other misc changes                                                                     about 15 days ago
google/docsy          #2542  Set version to 0.14.2-dev-001-over-main-20ff86e7, and more                                             user guide, CI/infra               about 15 days ago
google/docsy-example  #419   Upgrade to Docsy 0.14.1, page tweaks                                                                                                      about 18 days ago
google/docsy          #2540  Release 0.14.1 preparation                                                                                                                about 11 days ago
google/docsy          #2538  Fix ToC sidebar width in xl viewports                                                                  design/style, CI/infra             about 18 days ago
google/docsy-example  #418   Upgrade to Docsy 0.14.0, page tweaks                                                                                                      about 18 days ago
google/docsy          #2535  Release 0.14.0                                                                                                                            about 19 days ago
google/docsy          #2534  Release 0.14.0 preparation                                                                                                                about 19 days ago
google/docsy          #2533  Add RTL fixes for code blocks and foldable-nav icons                                                                                      about 19 days ago
google/docsy-example  #417   Add support for _redirects, and configure it for the blog posts                                                                           about 19 days ago
google/docsy-example  #416   Fix blog post with page bundle resources                                                                                                  about 19 days ago
google/docsy          #2531  Add cards with thumbnails to examples page, upgrade Hugo to 0.155.3                                                                       about 17 days ago
google/docsy-example  #415   Update to docsy v0.13.1-0.20260209191548                                                                                                  about 19 days ago
google/docsy          #2530  Promote examples page to navbar, rework CTA, hero images, and more                                                                        about 11 days ago
google/docsy          #2528  Adjust navbar heights and main-container layout                                                                                           about 20 days ago
google/docsy          #2527  Factor sidebar-toc styles, and 0.13.0 + 0.14.0 blog post improvements                                                                     about 21 days ago
google/docsy          #2525  Fix toc position on desktop, and left sidenav + main layout on tablet                                                                     about 21 days ago
google/docsy          #2524  Add dark overlay styles for GCS modal                                                                                                     about 21 days ago
google/docsy-example  #414   Update Docsy to v0.13.1-0.20260206173603 and use td-navbar-links-all-active for homepage                                                  about 22 days ago
google/docsy          #2521  Style adjustments and new bs-defaults.scss partial                                                                                        about 22 days ago
google/docsy          #2520  Add td-navbar-links-all-active to list of experimental styles in 0.14.0 blog post                      cleanup/refactoring                about 11 days ago
google/docsy          #2519  Opt-in dark navbar link contrast via homepage body_class                                                                                  about 23 days ago
google/docsy          #2518  Refresh refache, fix links, add local card images, and more                                            cleanup/refactoring                about 23 days ago
google/docsy-example  #413   Upgrade Docsy to v0.13.1-0.20260205235702-cec16119dd96, use anchor                                                                        about 23 days ago
google/docsy          #2517  Centralize btn-lg helper to Hugo params, use anchors not buttons                                                                          about 23 days ago
google/docsy-example  #412   Upgrade Docsy to v0.13.1-0.20260205160058                                                                                                 about 23 days ago
google/docsy          #2515  Adjust ToC and main layout breakpoints under td-no-left-sidebar                                                                           about 23 days ago
google/docsy          #2514  Add extra styles for cover CTA/layouts and update 0.14.0 blog post                                                                        about 24 days ago
google/docsy-example  #411   Update NPM packages, Hugo to 0.155.2                                                                   dependencies                       about 24 days ago
google/docsy          #2513  Adjust Hugo 0.152-0.155 upgrade guide title to better match new org                                                                       about 24 days ago
google/docsy          #2512  Rework Hugo upgrade post to make actions clearer                                                                                          about 25 days ago
google/docsy          #2511  Update NPM packages, Hugo to 0.155.2                                                                   dependencies                       about 25 days ago
google/docsy          #2509  Refactor navbar vars, anchors, and cover styles; update blog & CL                                                                         about 25 days ago
google/docsy          #2508  Improve 0.14.0 upgrade action-step guidance                                                                                               about 26 days ago
google/docsy          #2506  Document heading aliases and in-page targets                                                                                              about 26 days ago
google/docsy          #2505  Reorganize SCSS, fix scroll padding, normalize blocks-shortcode heading IDs and keep old IDs as alias                                     about 26 days ago
google/docsy          #2502  Update 0.14 release notes, Hugo upgrade guide, style adjustments, and more                             user guide, blog                   about 28 days ago
google/docsy          #2498  Fix grammatical error in Norwegian translation                                                         i18n                               about 25 days ago
google/docsy          #2494  chore(hugo.yaml): cleanup config and add some explanation                                                                                 about 25 days ago
google/docsy          #2481  docsy.dev: minor reorg and refactor SCSS                                                               design/style, cleanup/refactoring  about 25 days ago
google/docsy          #2480  Refactor blocks/cover and pageinfo shortcodes                                                                                             about 25 days ago
google/docsy          #2479  Add read-only contents permission to workflows                                                         CI/infra, security                 about 25 days ago
google/docsy          #2476  Add nested `sidebar_root_for` to docs                                                                  docsy-docs                         about 25 days ago
google/docsy          #2473  Update Swagger UI customization instructions                                                                                              about 25 days ago
google/docsy          #2471  Update 0.14.0 release docs with i18n and SCSS changes                                                                                     about 25 days ago
google/docsy          #2469  Move internal SCSS files into Docsy-specific subdirectory                                              cleanup/refactoring                about 25 days ago
google/docsy          #2468  Convert all remaining i18n files to YAML, add helper scripts                                           cleanup/refactoring, i18n          about 25 days ago
google/docsy          #2467  Add alert and table of contents labels to Hebrew i18n                                                  i18n                               about 25 days ago
google/docsy          #2466  Convert Hebrew translation file to YAML                                                                i18n                               about 25 days ago
google/docsy          #2464  Add alert labels and all-rights-reserved in Japanese                                                                                      about 25 days ago
google/docsy          #2463  Convert Japanese translations from TOML to YAML                                                                                           about 25 days ago
google/docsy          #2462  Add alert label translations for zh-cn and zh-tw                                                       i18n                               about 25 days ago
google/docsy          #2461  Convert Chinese i18n files from TOML to YAML                                                           i18n                               about 25 days ago
google/docsy          #2460  Address Hugo deprecation msg related to mounts                                                                                            about 25 days ago
google/docsy          #2459  Add Bengali translations for alert labels                                                              i18n                               about 25 days ago
google/docsy          #2458  Convert Bengali translations from TOML to YAML                                                         cleanup/refactoring, i18n          about 25 days ago
google/docsy          #2457  Convert most shortcode alerts to markdown, and more                                                    cleanup/refactoring, docsy-docs    about 25 days ago
google/docsy          #2455  Delete i18n/uk.toml since we have a .yaml format now                                                   i18n                               about 25 days ago
google/docsy          #2454  Convert i18n/uk.toml to .yaml                                                                          i18n                               about 25 days ago
google/docsy          #2452  Add support for custom attributes in blockquote alerts                                                 enhancement                        about 25 days ago
google/docsy          #2450  Add alert labels to selected i18n files                                                                i18n                               about 25 days ago
google/docsy          #2446  Add AGENTS.md, move a few project pages to be under About section                                      AI                                 about 25 days ago
google/docsy          #2445  chore: Rename 'site' docs section to 'project' and update links, and add task plan                     cleanup/refactoring                about 25 days ago
google/docsy          #2444  Add site build info and project build documentation                                                    CI/infra                           about 25 days ago
google/docsy          #2442  Add docs version as a badge                                                                                                               about 25 days ago