Release 0.14.0 preparation (google#2534)

Author: chalin

docsy.dev/content/en/blog/2026/0.14.0.md

@@ -5,7 +5,7 @@ date: 2026-02-10
 author: >-
   [Patrice Chalin](https://github.com/chalin) ([CNCF](https://www.cncf.io/)),
   for the [Docsy Steering Committee](/blog/2022/hello/#introducing-the-psc)
-body_class: release-highlights published-draft-post
+body_class: release-highlights
 tags: [release, upgrade]
 cSpell:ignore: docsy subrepo lightdark lookandfeel
 ---
@@ -99,8 +99,15 @@ authoring/tooling support:
   Markdown syntax.
 - Keep `alert` shortcodes when you rely on shortcode-specific behavior.
 
+> [!TIP]
+>
+> Using a script like [docsy-alerts-to-md/convert.pl][] can help with the
+> conversion process.
+
 [alert shortcode]: /docs/content/shortcodes/#alert
 [Alerts]: /docs/content/adding-content/#alerts
+[docsy-alerts-to-md/convert.pl]:
+  https://github.com/open-telemetry/opentelemetry.io/blob/main/scripts/docsy-alerts-to-md/convert.pl
 
 ## {{% _param BREAKING %}} Styles and customization {#styles-customization}
 
@@ -424,6 +431,7 @@ Docsy 0.14.0 includes the following style improvements and fixes:
 - `<details>` margin fixes
 - TOC h1 entries made slightly bolder so they are more visually distinct
 - Google-search modal support for dark mode ([#2524])
+- RTL: code blocks and foldable-nav icons ([#2533])
 
 [Experimental][] extra styles:
 
@@ -536,10 +544,14 @@ These quick checks relate to the style and behavior changes in 0.14.0.
 
 #### Advanced review {#advanced-overrides}
 
-**Applies if** your project overrides Docsy templates or shortcodes.
+**Applies if** your project overrides Docsy templates, shortcodes, assets, or
+i18n files.
 
 Review these updated files and port changes as needed:
 
+- [ ] [assets/js/base.js][]
+- [ ] [assets/scss files](#scss-actions)
+- [ ] [i18n files](#internationalization)
 - [ ] [layouts/\_markup/render-blockquote-alert.html][render-blockquote-alert.html]
 - [ ] [layouts/\_partials/navbar.html](#navbar-actions)
 - [ ] [layouts/\_partials/sidebar-tree.html][sidebar-tree.html]
@@ -554,6 +566,8 @@ Review these updated files and port changes as needed:
 - [ ] [layouts/docs/baseof.html][docs/baseof.html]
 - [ ] [layouts/swagger/baseof.html][swagger/baseof.html]
 
+[assets/js/base.js]:
+  <{{% param github_repo %}}/blob/main/assets/js/base.js?plain=1>
 [render-blockquote-alert.html]:
   <{{% param github_repo %}}/blob/main/layouts/_markup/render-blockquote-alert.html?plain=1>
 [sidebar.html]:
@@ -632,6 +646,7 @@ Other references:
 [#2480]: https://github.com/google/docsy/pull/2480
 [#2501]: https://github.com/google/docsy/issues/2501
 [#2524]: https://github.com/google/docsy/pull/2524
+[#2533]: https://github.com/google/docsy/pull/2533
 [#939]: https://github.com/google/docsy/issues/939
 [0.13.0]: /project/about/changelog/#v0.13.0
 [0.14.0]: https://github.com/google/docsy/releases/v0.14.0?no-link-check=1

docsy.dev/content/en/blog/2026/hugo-0.152.0+.md

@@ -1,11 +1,11 @@
 ---
 title: Hugo 0.152.0-0.155.x upgrade guide
 linkTitle: Hugo 0.152+ upgrade guide
-date: 2026-02-10
+date: 2026-02-09
 author: >-
   [Patrice Chalin](https://github.com/chalin) ([CNCF](https://www.cncf.io/)),
   for the [Docsy Steering Committee](/blog/2022/hello/#introducing-the-psc)
-body_class: release-highlights published-draft-post
+body_class: release-highlights
 tags: [hugo, upgrade]
 # prettier-ignore
 cSpell:ignore: docsy dartsass libsass IPTC multihost libwebp opentelemetry

docsy.dev/content/en/blog/_index.md

@@ -3,7 +3,6 @@ title: Blog
 menu: { main: { weight: 50 } }
 cascade:
   params:
-    # Icon usage: {{% _param FAS iconName color %}}
     BREAKING:
       <i class="fa-solid fa-triangle-exclamation fa-lg text-warning px-1"></i>
     NEW: <i class="fa-regular fa-square-check fa-lg text-success px-1"></i>

docsy.dev/content/en/project/about/changelog.md

@@ -110,11 +110,31 @@ Any other compatibility (including Windows support) is on a best effort basis.
 
 <!-- TODO: look into https://www.conventionalcommits.org/en/v1.0.0/#summary -->
 
-## v0.14.0 {#v0.14.0}
+## v0.14.1 or v0.15.0 {#v0.15.0}
 
 > **UNRELEASED: this planned version is still under development**
 
-For the full list of changes, see the [0.14.0] release page.
+For the full list of changes, see the [0.X.Y][] release page.
+
+[**Breaking changes**](#breaking-change):
+
+- ...
+
+**New**:
+
+**Other changes**:
+
+- ...
+
+[**Experimental**](#experimental):
+
+- ...
+
+[0.X.Y]: https://github.com/google/docsy/releases/latest?FIXME=v0.X.Y
+
+## v0.14.0 {#v0.14.0}
+
+For the full list of changes, see the [0.14.0][] release page.
 
 [**Breaking changes**](#breaking-change):
 
@@ -151,6 +171,7 @@ For the full list of changes, see the [0.14.0] release page.
   translations][0.14.0-blog-internationalization] for multiple locales.
 - Fixed nested **`sidebar_root_for`** bug ([#2470]).
 - Fixed Google-search modal colors in dark mode ([#2524]).
+- **RTL**: fixes for code blocks and foldable-nav icons ([#2533]).
 
 [#1654]: https://github.com/google/docsy/issues/1654
 [#2413]: https://github.com/google/docsy/issues/2413
@@ -159,6 +180,7 @@ For the full list of changes, see the [0.14.0] release page.
 [#2477]: https://github.com/google/docsy/pull/2477
 [#2480]: https://github.com/google/docsy/pull/2480
 [#2524]: https://github.com/google/docsy/pull/2524
+[#2533]: https://github.com/google/docsy/pull/2533
 [0.14.0]: https://github.com/google/docsy/releases/v0.14.0
 [0.14.0-blog-alerts]: /blog/2026/0.14.0/#alerts
 [0.14.0-blog-cover]: /blog/2026/0.14.0/#blocks-cover
@@ -750,7 +772,7 @@ For the full list of changes, see the [0.2.0] release page.
 
 > **UNRELEASED: this planned version is still under development**
 
-For the full list of changes, see the [0.X.Y] release page.
+For the full list of changes, see the [0.X.Y][] release page.
 
 [**Breaking changes**](#breaking-change):
 

docsy.dev/content/en/project/about/contributing.md

@@ -58,7 +58,8 @@ accordingly.
     - You'll create a new section for the next release in a later step.
 
 3.  **Update the release report blog post** for {{% param version %}}, if any.
-    Remove draft status.
+    - Remove draft status.
+    - Update the date to today's date.
 
 4.  Run `npm run fix`.
 
@@ -82,7 +83,7 @@ accordingly.
     e.g., vendor assets and [go.mod] dependencies are up-to-date, etc.
 
 7.  **Submit a PR with your changes**, using a title like "Release
-    {{% param version %}}" preparation". Use this command to create the PR via
+    {{% param version %}} preparation". Use this command to create the PR via
     the web interface:
 
     ```sh

docsy.dev/hugo.yaml

@@ -62,7 +62,7 @@ params:
     to_year: present
   privacy_policy: https://policies.google.com/privacy
   archived_version: false
-  version: 0.14.0-dev
+  version: 0.14.0
   github_repo: https://github.com/google/docsy
   github_project_repo: https://github.com/google/docsy
   github_subdir: docsy.dev

docsy.dev/static/refcache.json

@@ -695,6 +695,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-06T03:29:40.423254-05:00"
   },
+  "https://github.com/google/docsy/blob/main/assets/js/base.js": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-10T03:27:42.352128-05:00"
+  },
   "https://github.com/google/docsy/blob/main/assets/js/search.js": {
     "StatusCode": 206,
     "LastSeen": "2026-02-06T03:25:24.507139-05:00"
@@ -1387,6 +1391,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-07T08:36:51.533538-05:00"
   },
+  "https://github.com/google/docsy/pull/2533": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-10T05:39:39.864462-05:00"
+  },
   "https://github.com/google/docsy/pull/941": {
     "StatusCode": 206,
     "LastSeen": "2026-02-06T03:26:55.724479-05:00"
@@ -1663,6 +1671,10 @@
     "StatusCode": 206,
     "LastSeen": "2026-02-06T03:26:06.382859-05:00"
   },
+  "https://github.com/open-telemetry/opentelemetry.io/blob/main/scripts/docsy-alerts-to-md/convert.pl": {
+    "StatusCode": 206,
+    "LastSeen": "2026-02-10T03:27:41.83835-05:00"
+  },
   "https://github.com/open-telemetry/opentelemetry.io/issues": {
     "StatusCode": 206,
     "LastSeen": "2026-02-06T03:28:22.582088-05:00"

package.json

@@ -1,6 +1,6 @@
 {
   "name": "docsy",
-  "version": "0.14.0-dev+104-g8bc5f537-or-later-commit",
+  "version": "0.14.0",
   "repository": "github:google/docsy",
   "homepage": "https://www.docsy.dev",
   "license": "Apache-2.0",

tasks/0.14/commit-inventory.md

@@ -4,7 +4,7 @@ date: 2026-01-16
 cSpell:ignore: docsy frontmatter subrepo
 ---
 
-> Report refreshed for commits through `3753ff78` on `main`.
+> Report refreshed for commits through `29793a64` on `main`.
 
 Chronological list of [commits since v0.13.0][], broadly grouped into a few
 categories. We'll do a more detailed analysis and groupings when we create the
@@ -96,6 +96,43 @@ client projects.
 - `3753ff78` (#2505) Reorganize SCSS, fix scroll padding, normalize
   blocks-shortcode heading IDs and keep old IDs as alias
 
+### Since last refresh (3753ff78..29793a64)
+
+- `4dc710b4` (#2506) Document heading aliases and in-page targets
+- `0ddab73a` (#2508) Improve 0.14.0 upgrade action-step guidance
+- `88e96c7a` (#2509) Refactor navbar vars, anchors, and cover styles; update
+  blog & CL
+- `fe8683ca` (#2511) Update NPM packages, Hugo to 0.155.2
+- `d06e1406` (#2512) Rework Hugo upgrade post to make actions clearer
+- `c725abe7` (#2513) Adjust Hugo 0.152-0.155 upgrade guide title to better match
+  new org
+- `75e091ce` (#2514) Add extra styles for cover CTA/layouts and update 0.14.0
+  blog post
+- `5208380c` (#2515) Adjust ToC and main layout breakpoints under
+  td-no-left-sidebar
+- `ba02f629` (#2507) Fix typos, remove duplicate paragraph, and other copyedits
+- `cec16119` (#2517) Centralize btn-lg helper to Hugo params, use anchors not
+  buttons
+- `555ca48f` (#2518) Refresh refache, fix links, add local card images, and more
+- `4fdc4844` (#2519) Opt-in dark navbar link contrast via homepage body_class
+- `83e9a3e6` (#2520) Add td-navbar-links-all-active to list of experimental
+  styles in 0.14.0 blog post
+- `ec568185` (#2521) Style adjustments and new bs-defaults.scss partial
+- `6230b09e` (#2524) Add dark overlay styles for GCS modal
+- `cc2d0569` (#2525) Fix toc position on desktop, and left sidenav + main layout
+  on tablet
+- `a8db3e0d` (#2527) Factor sidebar-toc styles, and 0.13.0 + 0.14.0 blog post
+  improvements
+- `e27e4137` (#2528) Adjust navbar heights and main-container layout
+- `21112fb6` (#2516) Fix links in repository CHANGELOG.md & CONTRIBUTING.md
+- `9e8a9190` (#2510) Update Serbian (cyrillic & latin)
+- `901887d3` (#2526) Upgrade GitHub Actions for Node 24 compatibility
+- `234f18dd` (#2530) Promote examples page to navbar, rework CTA, hero images,
+  and more
+- `8bc5f537` (#2531) Add cards with thumbnails to examples page, upgrade Hugo to
+  0.155.3
+- `29793a64` (#2533) Add RTL fixes for code blocks and foldable-nav icons
+
 ## CI / tooling only
 
 - `66a0c7d` (#2440) Update README, contrib docs for deployment and release
@@ -120,5 +157,8 @@ client projects.
 - `9334955` (#2430) Upgrade Hugo to 0.154.3
 - `b52c265` (#2432) Update Hugo to 0.154.5
 - `6399194a` (#2486) Update devDeps, incl. Hugo to 0.155.0
+- `fe8683ca` (#2511) Update NPM packages, Hugo to 0.155.2
+- `8bc5f537` (#2531) Add cards with thumbnails to examples page, upgrade Hugo to
+  0.155.3
 
 [commits since v0.13.0]: https://github.com/google/docsy/compare/v0.13.0...main

tasks/0.14/issue-mapping.md

@@ -4,7 +4,7 @@ date: 2026-01-16
 cSpell:ignore: docsy
 ---
 
-> Report refreshed for commits through `3753ff78` on `main`.
+> Report refreshed for commits through `29793a64` on `main`.
 
 Mapping [commits since v0.13.0][] to their originating issues (when known).