diff --git a/.release-please-manifest.json b/.release-please-manifest.json index 895bf0e3..969d3dbf 100644 --- a/.release-please-manifest.json +++ b/.release-please-manifest.json @@ -1,3 +1,3 @@ { - ".": "2.0.0" + ".": "2.1.0" } diff --git a/AGENTS.md b/AGENTS.md index 9c3931a4..8579b31b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -193,7 +193,11 @@ generated page already. The site is versioned. `writerside.cfg` is generated for every language and carries the version from `package.json`, so the header names the release it was -built from, and `buildprofiles.xml` points the switcher at `help-versions.json` +built from. That line ends with an `x-release-please-version` annotation and the +five files are listed as `extra-files` in `release-please-config.json`, because +`release-please` would otherwise bump the version and leave the configurations a +release behind — which fails `npm run docs:check` on `main` and takes the deploy +with it. `buildprofiles.xml` points the switcher at `help-versions.json` at the site root. The deploy publishes each build twice — at the root as the current version, and under `//` as an archive — keeping the zips in a `docs-archive` branch, because Pages replaces everything it serves on every @@ -211,8 +215,9 @@ after all five builds sit in one directory — that is when it can know which pages exist in which language. The languages, and every label around the prose, are declared in -`scripts/docs/languages.mjs`. Adding a language is a change to that file and a -new matrix entry in `.github/workflows/docs.yml`; the rest follows. +`scripts/docs/languages.mjs`. Adding a language is a change to that file, a new +matrix entry in `.github/workflows/docs.yml` and its `writerside.cfg` in the +`extra-files` of `release-please-config.json`; the rest follows. ## 7. Parity is not attributed diff --git a/CHANGELOG.md b/CHANGELOG.md index 03418080..fafc2c07 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -1,5 +1,28 @@ # Changelog +## [2.1.0](https://github.com/MaksymStoianov/apps-script-utils/compare/apps-script-utils-v2.0.0...apps-script-utils-v2.1.0) (2026-09-23) + + +### Features + +* **docs:** link the translations under the breadcrumbs, and say once at the end that AI wrote this ([f880ce8](https://github.com/MaksymStoianov/apps-script-utils/commit/f880ce8d80822a7913a1354fe7e1b2e226a6c3cf)), closes [#539](https://github.com/MaksymStoianov/apps-script-utils/issues/539) +* **docs:** link the translations under the breadcrumbs, and the AI notice before the footer ([e89a2e8](https://github.com/MaksymStoianov/apps-script-utils/commit/e89a2e8790882961fceab00cdeeffa9d41373ead)) +* **docs:** link the translations under the breadcrumbs, and the AI notice before the footer ([2450cf7](https://github.com/MaksymStoianov/apps-script-utils/commit/2450cf7aa3e9f371f59edae7dffce7251b599533)) + + +### Bug Fixes + +* **docs:** declare the build settings per instance, and check they land ([f338835](https://github.com/MaksymStoianov/apps-script-utils/commit/f338835b8db2e5e121caebc076eced90bc86c2b9)) +* **docs:** declare the build settings per instance, and check they land ([7407642](https://github.com/MaksymStoianov/apps-script-utils/commit/7407642b6b95424a96be57e1eef13655c5dc7bc1)), closes [#539](https://github.com/MaksymStoianov/apps-script-utils/issues/539) +* **docs:** keep the injections — the build profile really is inert ([d646f6b](https://github.com/MaksymStoianov/apps-script-utils/commit/d646f6b138d62cc755dac23bdd414b2798ab3a98)), closes [#539](https://github.com/MaksymStoianov/apps-script-utils/issues/539) +* **docs:** mount the header controls reliably, and put the notice in the article ([ab18695](https://github.com/MaksymStoianov/apps-script-utils/commit/ab1869569f042f188c95117df8a703b49cd9964f)), closes [#539](https://github.com/MaksymStoianov/apps-script-utils/issues/539) +* **docs:** put the build profile at the solution root ([6cd294a](https://github.com/MaksymStoianov/apps-script-utils/commit/6cd294a77581f8d7eefe59c102fa00acfbe8f71c)), closes [#539](https://github.com/MaksymStoianov/apps-script-utils/issues/539) +* **docs:** put the language and search controls in the header ([354a443](https://github.com/MaksymStoianov/apps-script-utils/commit/354a4436bf0cd6b8fecec452492989f78ee782aa)) +* **docs:** put the language and search controls in the header ([6c69ee6](https://github.com/MaksymStoianov/apps-script-utils/commit/6c69ee6abfa0238ff4e265a13470dd0510a6e184)) +* **docs:** put the language and search controls in the header ([d578dc9](https://github.com/MaksymStoianov/apps-script-utils/commit/d578dc95cd7e308d0ebd151263361438dc0eaf69)), closes [#539](https://github.com/MaksymStoianov/apps-script-utils/issues/539) +* **docs:** write the head, the switcher and the notice in after the build ([d281d6f](https://github.com/MaksymStoianov/apps-script-utils/commit/d281d6f14552c357b77824069f839bc8320c1941)) +* **docs:** write the head, the switcher and the notice in after the build ([85b127e](https://github.com/MaksymStoianov/apps-script-utils/commit/85b127e65654f9472d0142bc92e0fce7cefd063c)), closes [#539](https://github.com/MaksymStoianov/apps-script-utils/issues/539) + ## [2.0.0](https://github.com/MaksymStoianov/apps-script-utils/compare/apps-script-utils-v1.10.0...apps-script-utils-v2.0.0) (2026-09-23) diff --git a/docs/writerside-de/writerside.cfg b/docs/writerside-de/writerside.cfg index ce74fe9e..84d70024 100644 --- a/docs/writerside-de/writerside.cfg +++ b/docs/writerside-de/writerside.cfg @@ -5,5 +5,5 @@ - + diff --git a/docs/writerside-fr/writerside.cfg b/docs/writerside-fr/writerside.cfg index ce74fe9e..84d70024 100644 --- a/docs/writerside-fr/writerside.cfg +++ b/docs/writerside-fr/writerside.cfg @@ -5,5 +5,5 @@ - + diff --git a/docs/writerside-ru/writerside.cfg b/docs/writerside-ru/writerside.cfg index ce74fe9e..84d70024 100644 --- a/docs/writerside-ru/writerside.cfg +++ b/docs/writerside-ru/writerside.cfg @@ -5,5 +5,5 @@ - + diff --git a/docs/writerside-uk/writerside.cfg b/docs/writerside-uk/writerside.cfg index ce74fe9e..84d70024 100644 --- a/docs/writerside-uk/writerside.cfg +++ b/docs/writerside-uk/writerside.cfg @@ -5,5 +5,5 @@ - + diff --git a/docs/writerside/writerside.cfg b/docs/writerside/writerside.cfg index ce74fe9e..84d70024 100644 --- a/docs/writerside/writerside.cfg +++ b/docs/writerside/writerside.cfg @@ -5,5 +5,5 @@ - + diff --git a/package-lock.json b/package-lock.json index 7e05339c..2f1fbc6d 100644 --- a/package-lock.json +++ b/package-lock.json @@ -1,12 +1,12 @@ { "name": "apps-script-utils", - "version": "2.0.0", + "version": "2.1.0", "lockfileVersion": 3, "requires": true, "packages": { "": { "name": "apps-script-utils", - "version": "2.0.0", + "version": "2.1.0", "funding": [ { "type": "github", diff --git a/package.json b/package.json index fe11fccf..883d6c59 100644 --- a/package.json +++ b/package.json @@ -1,6 +1,6 @@ { "name": "apps-script-utils", - "version": "2.0.0", + "version": "2.1.0", "description": "Utilities for Google Apps Script™ projects.", "main": "dist/index.js", "types": "dist/index.d.ts", diff --git a/release-please-config.json b/release-please-config.json index e0257e19..697a7858 100644 --- a/release-please-config.json +++ b/release-please-config.json @@ -4,7 +4,14 @@ ".": { "release-type": "node", "package-name": "apps-script-utils", - "changelog-path": "CHANGELOG.md" + "changelog-path": "CHANGELOG.md", + "extra-files": [ + "docs/writerside/writerside.cfg", + "docs/writerside-ru/writerside.cfg", + "docs/writerside-uk/writerside.cfg", + "docs/writerside-de/writerside.cfg", + "docs/writerside-fr/writerside.cfg" + ] } } } diff --git a/scripts/docs/site.mjs b/scripts/docs/site.mjs index 9ae6d3a3..82f3749a 100644 --- a/scripts/docs/site.mjs +++ b/scripts/docs/site.mjs @@ -34,6 +34,14 @@ function widget(language) { const ARTWORK = "https://darynamikhailenko.com/?utm_source=docs&utm_medium=footer&utm_campaign=apps-script-utils&utm_content=banner-artist-credit"; +/** + * The version on the instance line carries the `x-release-please-version` + * annotation, because `release-please` bumps `package.json` without knowing + * that five generated files repeat the version it writes. The annotation is + * what its generic updater looks for, so the release pull request rewrites + * these configurations along with the version, and the check that compares the + * generated files to the sources still passes once the release lands. + */ export function writersideCfg(version) { return ` @@ -42,7 +50,7 @@ export function writersideCfg(version) { - + `; }