Update 0.14 release notes, Hugo upgrade guide, style adjustments, and more (#2502)

Author: chalin

.vscode/cspell.json

@@ -4,6 +4,8 @@
   "caseSensitive": true,
   "words": [
     "anchorize",
+    "chalin",
+    "CNCF",
     "docset",
     "docsets",
     "Docsy",
@@ -15,10 +17,12 @@
     "htmltest",
     "hugo",
     "isset",
+    "lastmod",
     "markdownify",
     "navbars",
     "nvmrc",
     "Occitan",
+    "pageinfo",
     "refcache",
     "relref",
     "scrollspy",

README.md

@@ -1,14 +1,17 @@
 # Docsy
 
-> **🚧 WARNING 🚧 : `main` is under development and potentially unstable! Use
-> official Docsy [releases].**
-
 Docsy is a [Hugo](https://gohugo.io) theme for technical documentation sets,
 providing simple navigation, site structure, and more.
 
 This is not an officially supported Google product. This project is actively
 being maintained.
 
+> [!IMPORTANT] 🚧 IMPORTANT 🚧
+>
+> The `main` branch is under development and not officially supported; use
+> official Docsy [releases]. For full support details, see [Official support
+> limits][official-support].
+
 ## Prerequisites
 
 The following are basic prerequisites for using Docsy in your site:
@@ -103,6 +106,11 @@ This project is licensed under the Apache License 2.0, see
 [deploys]: https://app.netlify.com/sites/docsydocs/deploys
 [main-preview]: https://main--docsydocs.netlify.app/
 [netlify]: https://netlify.com
+
+<!-- FIXME: once 0.14.0 is released, update the link to the changelog page -->
+
+[official-support]:
+  https://www.docsy.dev/blog/2024/0.10.0/#hugo-breaking-changes-and-deprecation-notices
 [releases]: https://github.com/google/docsy/releases
 
 <!-- cSpell:ignore docsy -->

assets/scss/td/_content.scss

@@ -83,6 +83,16 @@
     margin-bottom: 2 * $spacer;
   }
 
+  details {
+    &:not(:last-child) {
+      margin-bottom: $spacer;
+    }
+
+    > p:first-of-type {
+      margin-top: $spacer;
+    }
+  }
+
   .lead {
     margin-bottom: 1.5rem;
   }

assets/scss/td/_sidebar-toc.scss

@@ -78,6 +78,7 @@
   }
 
   #TableOfContents {
+    --td-toc-h1-font-weight-delta: 200;
     margin-left: -0.75rem;
 
     a {
@@ -101,6 +102,12 @@
       }
     }
 
+    > ul > li > :not(ul) {
+      font-weight: calc(
+        var(--bs-body-font-weight, 400) + var(--td-toc-h1-font-weight-delta)
+      );
+    }
+
     ul ul a {
       padding-left: $toc-padding-base + $toc-padding-increment;
     }

assets/scss/td/extra/_index.scss

@@ -2,3 +2,21 @@
 // eventually be merged into the core Docsy theme.
 
 @import 'navbar';
+
+// Margin fix for nested lists [EXPERIMENTAL]
+
+body {
+  // --td-nested-lists-last-item-margin: initial;
+
+  &:not(.td-disable-nested-lists-last-item-margin) {
+    .td-content {
+      --td-nested-lists-last-item-margin: 1rem;
+
+      li > ul {
+        > li:last-child {
+          margin-bottom: var(--td-nested-lists-last-item-margin);
+        }
+      }
+    }
+  }
+}

assets/scss/td/main.scss

@@ -56,7 +56,9 @@
   h2[id]::before,
   h3[id]::before,
   h4[id]::before,
-  h5[id]::before {
+  h5[id]::before,
+  h6[id]::before,
+  .td-offset-anchor::before {
     $td-anchor-offset-delta: 1.5rem;
     display: block;
     content: ' ';

docsy.dev/content/en/blog/2023/0.7.x.md

@@ -7,7 +7,7 @@ author: >
   [Docsy Steering Committee](/blog/2022/hello/#introducing-the-psc))
 date: 2023-08-03
 aliases: [docsy-0.7]
-cSpell:ignore: CNCF Chalin opentelemetry namespacing docsy
+cSpell:ignore: opentelemetry namespacing docsy
 ---
 
 Last June, Docsy celebrated a significant milestone with the release of version

docsy.dev/content/en/blog/2023/bootstrap-5-migration.md

@@ -9,7 +9,7 @@ author: >
   [Docsy Steering Committee](/blog/2022/hello/#introducing-the-psc))
 date: 2023-06-05
 canonical_url: https://www.cncf.io/blog/2023/06/05/migrating-docsy-to-bootstrap-5/
-cSpell:ignore: CNCF Chalin opentelemetry techdocs
+cSpell:ignore: opentelemetry techdocs
 ---
 
 [Docsy](https://docsy.dev), and Docsy-based project websites ([including those

docsy.dev/content/en/blog/2023/priorities-for-2024.md

@@ -6,7 +6,7 @@ author: >
   for the [Docsy Steering Committee](/blog/2022/hello/#introducing-the-psc)
 date: 2023-11-28
 # prettier-ignore
-cSpell:ignore: CNCF Chalin opentelemetry namespacing docsy customizability deprioritize
+cSpell:ignore: opentelemetry namespacing docsy customizability deprioritize
 ---
 
 > **TL;DR** 1.4K projects use Docsy! The top user-project focused priorities for

docsy.dev/content/en/blog/2024/0.10.0.md

@@ -5,8 +5,9 @@ author: >
   [Patrice Chalin](https://github.com/chalin) ([CNCF](https://www.cncf.io/)),
   for the [Docsy Steering Committee](/blog/2022/hello/#introducing-the-psc)
 date: 2024-05-01
+lastmod: 2026-01-31
 # prettier-ignore
-cSpell:ignore: CNCF Chalin subdir deprecat upvoted pageinfo lookandfeel lightdark
+cSpell:ignore: subdir deprecat upvoted pageinfo lookandfeel lightdark
 ---
 
 The big news with Docsy [0.10.0] is color themes and dark mode!
@@ -21,14 +22,10 @@ this Docsy version, review Hugo's deprecation notices and breaking changes since
 
 [0.123.0]: https://github.com/gohugoio/hugo/releases/tag/v0.123.0
 
-> [!NOTE] Hugo version support reminder
+> [!IMPORTANT] Reminder
 >
-> Each Docsy version officially **only** supports the Hugo version specified in
-> the project's [package.json] entry for [hugo-extended]. Any other
-> compatibility is on a best effort basis.
->
-> [hugo-extended]: https://github.com/jakejarvis/hugo-extended
-> [package.json]: https://github.com/google/docsy/blob/main/package.json
+> For the official support limits for Docsy and its peer packages, see
+> [Official support limits](/project/about/changelog/#official-support).
 
 A number of updates to this release were to address Hugo's deprecation notices.
 For the complete list, search for [0.10.0] release changes with "deprecat" in