Release 0.14.2 preparation (#2551)

Author: chalin

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

@@ -68,8 +68,8 @@ cSpell:ignore: docsy subrepo lightdark lookandfeel onedark
     processing
   - {{% _param BREAKING %}}
     [Hugo 0.155.0 requirement and 0.153+ breaking changes](#hugo)
-  - {{% _param BREAKING %}} [Docsy 0.14.2 code-style update](#0.14.2) for
-    light/dark mode
+  - {{% _param BREAKING %}} (style-only)
+    [Docsy 0.14.2 code-style update](#0.14.2) for light/dark mode
 - Optionally skim:
   - {{% _param NEW %}} New features (look for the green checkmark icon)
   - {{% _param CLEANUP %}} Cleanup / improvement opportunities (look for this

docsy.dev/content/en/docs/contributing.md

@@ -13,10 +13,10 @@ make Docsy and its docs even better.
 >
 > We welcome your contributions but note that:
 >
-> - We cannot guarantee when pull requests will be reviewed.
+> - We cannot guarantee _when_ your [pull requests][pr] (PRs) will be reviewed.
 > - Review does not guarantee acceptance or merging.
-> - We may reject pull requests with content (e.g., AI-generated) that does not
->   meet our quality standards.
+> - We may reject PRs with content (e.g., AI-generated) that does not meet our
+>   quality standards.
 
 > [!NB] Maintainers, see [Maintainer notes](/project/about/contributing/).
 
@@ -75,7 +75,7 @@ familiar with basic GitHub workflows.
 
 1. Fork the [Docsy repo](https://github.com/google/docsy) on GitHub: this site's
    files live in the `docsy.dev` subdirectory.
-1. Make your changes and send a pull request (PR).
+1. Make your changes and send a [pull request][pr] (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
    the page front matter, because that prevents the auto-deployment of the
@@ -210,3 +210,6 @@ fix it yourself, please create an issue in
 [this repository](https://github.com/google/docsy). 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.
+
+[PR]:
+  https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/proposing-changes-to-your-work-with-pull-requests/creating-a-pull-request

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

@@ -150,7 +150,7 @@ For the full list of changes, see the [0.15.0][] release page.
 For the full list of changes, see the [release report][0.14.2-blog] and
 [0.14.2][] release page.
 
-[**Breaking changes**](#breaking-change):
+[**Breaking changes**](#breaking-change) (style-only):
 
 - **[Default code styles][0.14.2-blog]** changed from `tango`/`onedark` to
   `friendly`/`native` for sites using `td/code-dark` ([#2548]).

docsy.dev/content/en/project/about/maintainer-notes.md

@@ -19,43 +19,68 @@ accordingly.
 2.  **Create or update a [changelog][] entry** for {{% param version %}}.
     - The section should provide a brief summary of breaking changes using the
       section template at the end of the file.
-    - Ensure to remove the UNRELEASED note.
+    - Ensure to remove the UNRELEASED note, if still present.
     - 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.
-    - Update the date to today's date.
+    - Set `date` (or `lastmod` if already published) to today's date.
 
 4.  Run `npm run fix`.
 
-    > Note: This might update the version in `package.json` via `fix:version`,
+    > [!NOTE]
+    >
+    > This command might update the version in `package.json` via `fix:version`,
     > but you can ignore this change since you'll be setting the version
     > explicitly in the next step.
 
 5.  **Update Docsy version** to {{% param version %}} using the following from a
-    (bash or zsh) terminal:
+    (bash or zsh) terminal.
+    - First set the `VERSION` variable; we use it throughout the steps below.
 
-    ```sh
-    VERSION={{% param version %}}
-    npm run set:version -- --version $VERSION
-    ```
+      ```sh
+      VERSION={{% param version %}}
+      ```
+
+    - Then run the `set:version` script.
 
-    This updates both `version` keys in [package.json] and
-    [docsy.dev/hugo.yaml]. You can omit the argument to `--version` when the
-    package is already a dev version of {{% param version %}}.
+      Docsy is probably already at `{{% param version %}}-dev`, so you can run:
+
+      ```sh
+      npm run set:version
+      ```
+
+      Otherwise, set the version explicitly:
+
+      ```sh
+      npm run set:version -- --version $VERSION
+      ```
+
+      Both forms update the `version` related fields in [package.json][] and
+      [docsy.dev/hugo.yaml][].
 
 6.  <a id="ci-test-step">Run `npm run ci:test`</a>, which runs `ci:prepare` and
     more to ensure that, 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
-    the web interface:
+7.  **Submit a PR with your changes**.
+    - Commit any changes accumulated from the previous steps using this title:
 
-    ```sh
-    gh pr create --web --title "Release $VERSION preparation" \
-      --body "- Contributes to #<ADD-RELEASE-PREP-ISSUE-HERE>"
-    ```
+      ```text
+      Release {{% param version %}} preparation
+      ```
+
+    - Create a PR (with version-checks disabled) using the following command
+      that will open a PR-creation page in your browser:
+
+      ```sh
+      export SKIP_VERSION_CHECK=1
+      gh pr create --web --title "Release $VERSION preparation" \
+        --body "- Contributes to #<ADD-RELEASE-PREP-ISSUE-HERE>"
+      ```
+
+    - Use the web interface to fill in the PR details.
+    - Submit the PR.
 
 8.  **Test the PR** branch from selected sites, and push any required
     adjustments.

docsy.dev/hugo.yaml

@@ -62,8 +62,8 @@ params:
     to_year: present
   privacy_policy: https://policies.google.com/privacy
   archived_version: false
-  version: 0.14.2-dev
-  versionWithBuildId: 0.14.2-dev+007-over-main-a1ddcab5
+  version: 0.14.2
+  versionWithBuildId: 0.14.2
   github_repo: https://github.com/google/docsy
   github_project_repo: https://github.com/google/docsy
   github_subdir: docsy.dev

package.json

@@ -1,6 +1,6 @@
 {
   "name": "docsy",
-  "version": "0.14.2-dev+007-over-main-a1ddcab5",
+  "version": "0.14.2",
   "repository": "github:google/docsy",
   "homepage": "https://www.docsy.dev",
   "license": "Apache-2.0",