Skip to content

Commit 20ff86e

Browse files
authored
Release 0.14.1 preparation (#2540)
1 parent 37be7dc commit 20ff86e

File tree

13 files changed

+133
-43
lines changed

13 files changed

+133
-43
lines changed

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

Lines changed: 13 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -10,6 +10,12 @@ tags: [release, upgrade]
1010
cSpell:ignore: docsy subrepo lightdark lookandfeel
1111
---
1212

13+
> [!INFO] Patch update: 0.14.1 <a id="patch-update-0-14-1"></a>
14+
>
15+
> Docsy 0.14.1 is a patch release with one fix: Fixed ToC sidebar width in xl
16+
> viewports ([#2538]). If you are upgrading now, follow this guide and use
17+
> 0.14.1 where it references 0.14.0.
18+
1319
<style>
1420
li > div.alert-nb { margin: 0.5rem 0 !important;}
1521
</style>
@@ -471,10 +477,10 @@ changes require action:
471477

472478
Some upgrade steps are the same for each Docsy release (for example, updating
473479
your Docsy NPM package or Hugo module). Those steps are described in [Upgrade to
474-
Docsy 0.12.0][]: follow them, using version **0.14.0** where the guide refers to
480+
Docsy 0.12.0][]: follow them, using version **0.14.1** where the guide refers to
475481
0.12.0. For this release, use:[^vers-note]
476482

477-
- **Docsy**: [0.13.0][0.14.0]
483+
- **Docsy**: [0.13.0][0.14.1]
478484
- **Hugo**: 0.152.2 → 0.155.0 or later, see [Hugo 0.152.0-0.155.x upgrade
479485
guide][hugo-0.152.0+]
480486
- **Node**: LTS 24 (unchanged)
@@ -628,8 +634,8 @@ an [issue] or starting a [discussion].
628634

629635
About this release:
630636

631-
- [0.14.0 **changelog**][[email protected]] entry
632-
- [0.14.0 **release**][0.14.0] page
637+
- [0.14.0][[email protected]] and [0.14.1][[email protected]] changelog entries
638+
- [0.14.0][0.14.0] and [0.14.1][0.14.1] release pages
633639
- [Release 0.14.0 preparation **issue** (#2404)][#2404]
634640

635641
Other references:
@@ -647,12 +653,15 @@ Other references:
647653
[#2501]: https://github.com/google/docsy/issues/2501
648654
[#2524]: https://github.com/google/docsy/pull/2524
649655
[#2533]: https://github.com/google/docsy/pull/2533
656+
[#2538]: https://github.com/google/docsy/pull/2538
650657
[#939]: https://github.com/google/docsy/issues/939
651658
[0.13.0]: /project/about/changelog/#v0.13.0
652659
[0.14.0]: https://github.com/google/docsy/releases/v0.14.0?no-link-check=1
660+
[0.14.1]: https://github.com/google/docsy/releases/v0.14.1?no-link-check=1
653661
[Advanced style customization]:
654662
/docs/content/lookandfeel/#advanced-style-customization
655663
[[email protected]]: /project/about/changelog/#v0.14.0
664+
[[email protected]]: /project/about/changelog/#v0.14.1
656665
[experimental]: /project/about/changelog/#experimental
657666
[hugo-0.152.0+]: /blog/2026/hugo-0.152.0+/
658667
[officially supports]: /project/about/changelog/#official-support

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

Lines changed: 16 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -110,18 +110,20 @@ Any other compatibility (including Windows support) is on a best effort basis.
110110

111111
<!-- TODO: look into https://www.conventionalcommits.org/en/v1.0.0/#summary -->
112112

113-
## v0.14.1 or v0.15.0 {#v0.15.0}
113+
## v0.14.2 or v0.15.0 {#v0.15.0}
114114

115115
> **UNRELEASED: this planned version is still under development**
116116
117-
For the full list of changes, see the [0.X.Y][] release page.
117+
For the full list of changes, see the [0.15.0][] release page.
118118

119119
[**Breaking changes**](#breaking-change):
120120

121121
- ...
122122

123123
**New**:
124124

125+
- ...
126+
125127
**Other changes**:
126128

127129
- ...
@@ -130,7 +132,15 @@ For the full list of changes, see the [0.X.Y][] release page.
130132

131133
- ...
132134

133-
[0.X.Y]: https://github.com/google/docsy/releases/latest?FIXME=v0.X.Y
135+
[0.15.0]: https://github.com/google/docsy/releases/latest?FIXME=v0.15.0
136+
137+
## v0.14.1 {#v0.14.1}
138+
139+
Patch release [0.14.1][]:
140+
141+
- Fixed **ToC** sidebar width in xl viewports ([#2538]).
142+
143+
[0.14.1]: https://github.com/google/docsy/releases/v0.14.1
134144

135145
## v0.14.0 {#v0.14.0}
136146

@@ -181,6 +191,7 @@ For the full list of changes, see the [0.14.0][] release page.
181191
[#2480]: https://github.com/google/docsy/pull/2480
182192
[#2524]: https://github.com/google/docsy/pull/2524
183193
[#2533]: https://github.com/google/docsy/pull/2533
194+
[#2538]: https://github.com/google/docsy/pull/2538
184195
[0.14.0]: https://github.com/google/docsy/releases/v0.14.0
185196
[0.14.0-blog-alerts]: /blog/2026/0.14.0/#alerts
186197
[0.14.0-blog-cover]: /blog/2026/0.14.0/#blocks-cover
@@ -780,6 +791,8 @@ For the full list of changes, see the [0.X.Y][] release page.
780791
781792
**New**:
782793
794+
- ...
795+
783796
**Other changes**:
784797
785798
- ...

docsy.dev/hugo.yaml

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -62,7 +62,7 @@ params:
6262
to_year: present
6363
privacy_policy: https://policies.google.com/privacy
6464
archived_version: false
65-
version: 0.14.1-dev-001-over-main-617b5960
65+
version: 0.14.1
6666
github_repo: https://github.com/google/docsy
6767
github_project_repo: https://github.com/google/docsy
6868
github_subdir: docsy.dev

docsy.dev/layouts/_shortcodes/release-summary.md

Lines changed: 16 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -12,20 +12,30 @@
1212
{{ errorf "%s: shortcode 'release-summary': version parameter not found in page or site params" .Position -}}
1313
{{ end -}}
1414

15-
{{/* Get the blog section index page and search for a post matching the version */ -}}
15+
{{/* Same major.minor with patch 0, for blog lookup when there is no post for this patch (e.g. 0.14.1 → 0.14.0) */ -}}
16+
{{ $parts := split $version "." -}}
17+
{{ $versionForBlog := $version -}}
18+
{{ if and (ge (len $parts) 3) (ne (index $parts 2) "0") -}}
19+
{{ $versionForBlog = printf "%s.%s.0" (index $parts 0) (index $parts 1) -}}
20+
{{ end -}}
21+
22+
{{/* Get the blog section and search for a post: exact version first, then same release with patch 0 */ -}}
1623
{{ $blogSection := $.Site.GetPage "/blog" -}}
1724
{{ $blogPage := false -}}
1825
{{ $currentYear := now.Year -}}
1926
{{ $years := slice $currentYear (add $currentYear -1) -}}
20-
{{ range $years -}}
21-
{{ $postPath := printf "%d/%s" . $version -}}
22-
{{ $blogPage = $blogSection.GetPage $postPath -}}
27+
{{ range $ver := (slice $version $versionForBlog) -}}
2328
{{ if $blogPage }}{{ break }}{{ end -}}
29+
{{ range $years -}}
30+
{{ $postPath := printf "%d/%s" . $ver -}}
31+
{{ $blogPage = $blogSection.GetPage $postPath -}}
32+
{{ if $blogPage }}{{ break }}{{ end -}}
33+
{{ end -}}
2434
{{ end -}}
2535

2636
{{ if and (not $blogPage) (not $isDevVersion) -}}
27-
{{ errorf "%s: shortcode 'release-summary': blog post not found for version %q during years: %q"
28-
.Position $version (delimit $years ", ") -}}
37+
{{ errorf "%s: shortcode 'release-summary': blog post not found for version %q (tried %q) during years: %q"
38+
.Position $version (delimit (slice $version $versionForBlog) ", ") (delimit $years ", ") -}}
2939
{{ end -}}
3040

3141
{{ $changelogURL := printf "/project/about/changelog/#v%s" $version -}}

docsy.dev/static/refcache.json

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1395,6 +1395,10 @@
13951395
"StatusCode": 206,
13961396
"LastSeen": "2026-02-10T05:39:39.864462-05:00"
13971397
},
1398+
"https://github.com/google/docsy/pull/2538": {
1399+
"StatusCode": 206,
1400+
"LastSeen": "2026-02-10T17:08:41.899383-05:00"
1401+
},
13981402
"https://github.com/google/docsy/pull/941": {
13991403
"StatusCode": 206,
14001404
"LastSeen": "2026-02-06T03:26:55.724479-05:00"
@@ -1451,6 +1455,10 @@
14511455
"StatusCode": 206,
14521456
"LastSeen": "2026-02-06T04:20:52.669258-04:30"
14531457
},
1458+
"https://github.com/google/docsy/releases/v0.14.1": {
1459+
"StatusCode": 206,
1460+
"LastSeen": "2026-02-10T17:08:41.711763-05:00"
1461+
},
14541462
"https://github.com/google/docsy/releases/v0.2.0": {
14551463
"StatusCode": 206,
14561464
"LastSeen": "2026-02-06T03:29:34.567718-05:00"

package.json

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,6 @@
11
{
22
"name": "docsy",
3-
"version": "0.14.1-dev-001-over-main-617b5960",
3+
"version": "0.14.1",
44
"repository": "github:google/docsy",
55
"homepage": "https://www.docsy.dev",
66
"license": "Apache-2.0",

scripts/set-package-version/hugo-yaml.mjs

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,7 @@
11
#!/usr/bin/env node
22

3+
// cSpell:ignore docsy
4+
35
/**
46
* Utilities for reading and writing the version field in docsy.dev/hugo.yaml.
57
*/

scripts/set-package-version/index.mjs

Lines changed: 26 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -3,7 +3,7 @@
33
/**
44
* Updates the version in package.json and optionally docsy.dev/hugo.yaml.
55
* Can set the entire version or add/remove a build ID suffix.
6-
* The hugo.yaml file is only updated when --version is used.
6+
* The hugo.yaml file is updated when --version is used.
77
*
88
* For usage, see the usage() function below.
99
*
@@ -38,10 +38,15 @@ export function main(
3838

3939
const currentVersion = pkg.version;
4040
let newVersion;
41+
const removeDevSuffixOnly = version === '';
4142

4243
if (version !== undefined) {
43-
// --version takes precedence: set the entire version directly
44-
newVersion = version;
44+
if (removeDevSuffixOnly) {
45+
newVersion = removeDevSuffix(currentVersion);
46+
} else {
47+
// --version takes precedence: set the entire version directly
48+
newVersion = version;
49+
}
4550
} else {
4651
// Use build ID logic: add/remove build ID from base version
4752
const baseVersion = currentVersion.split('+')[0]; // Remove existing build ID if present
@@ -57,7 +62,7 @@ export function main(
5762
updated = true;
5863
}
5964

60-
// Only update hugo.yaml when --version is used
65+
// Update hugo.yaml when --version is used.
6166
let currentHugoVersion = '';
6267
if (version !== undefined) {
6368
const baseVersion = newVersion.split('+')[0]; // Remove build ID if present
@@ -90,16 +95,19 @@ export function main(
9095
const usageText = `
9196
Usage: node scripts/set-package-version/index.mjs [options]
9297
Options:
93-
--silent, -s Don't log any messages
94-
--help, -h Show this help message
95-
--version VERS Set the entire version to VERS
98+
--silent|-s Don't log any messages
99+
--help|-h Show this help message
100+
--version|-v VERS Set the entire version to VERS
96101
--id BUILD-ID Set build ID to BUILD-ID (ignored if --version is used)
97102
98103
Behavior:
99-
- If --version VERS is provided: sets the version to VERS in both package.json and hugo.yaml
100-
- If --id BUILD-ID is provided: adds BUILD-ID to the base version (package.json only)
101-
- If --id "" is provided: removes the build ID (package.json only)
102-
- If no --version or --id is provided: auto-generates build ID from timestamp (package.json only)
104+
--version VERS : sets the version to VERS in both package.json and hugo.yaml
105+
--version [''] : strips version to be just X.Y.Z in package.json and hugo.yaml
106+
--id BUILD-ID : adds BUILD-ID to the base version (package.json only)
107+
--id [''] : removes the build ID (package.json only)
108+
109+
When neither --version nor --id is provided: auto-generates build ID from
110+
timestamp (package.json only)
103111
`;
104112

105113
export function parseArgsAndResolveBuildId(args, { logger = console } = {}) {
@@ -126,12 +134,11 @@ export function parseArgsAndResolveBuildId(args, { logger = console } = {}) {
126134
silent = true;
127135
break;
128136
case '--version':
129-
if (++i >= args.length) usage(1);
130-
version = args[i];
137+
case '-v':
138+
version = ++i >= args.length ? '' : args[i];
131139
break;
132140
case '--id':
133-
if (++i >= args.length) usage(1);
134-
buildId = args[i];
141+
buildId = ++i >= args.length ? '' : args[i];
135142
break;
136143
default:
137144
warn?.(`Unexpected argument: ${arg}`);
@@ -205,6 +212,10 @@ export function adjustVersionForBuildId(
205212
return `${baseVersion}-dev+${buildId}`;
206213
}
207214

215+
export function removeDevSuffix(version) {
216+
return version.replace(/-dev(?:[0-9A-Za-z.-]*)?(?:\+.*)?$/, '');
217+
}
218+
208219
function defaultReadPackageJson() {
209220
return JSON.parse(fs.readFileSync(packagePath, 'utf8'));
210221
}

scripts/set-package-version/index.test.mjs

Lines changed: 34 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -275,6 +275,40 @@ test('main --version takes precedence over --id', () => {
275275
]);
276276
});
277277

278+
test('main removes -dev suffix with --version "" and updates hugo.yaml', () => {
279+
const pkg = { version: '1.2.3-dev+build-123' };
280+
const hugoYaml = { params: { version: '1.2.3-dev' } };
281+
let writtenPkg;
282+
let writtenHugoYaml;
283+
const messages = [];
284+
const logger = {
285+
log(message) {
286+
messages.push(message);
287+
},
288+
};
289+
290+
const newVersion = main(['--version', ''], {
291+
logger,
292+
readPackageJson: () => pkg,
293+
writePackageJson: (updatedPkg) => {
294+
writtenPkg = { ...updatedPkg };
295+
},
296+
readHugoYaml: () => ({ ...hugoYaml }),
297+
writeHugoYaml: (updatedYaml) => {
298+
writtenHugoYaml = { ...updatedYaml };
299+
},
300+
});
301+
302+
assert.equal(pkg.version, '1.2.3');
303+
assert.deepEqual(writtenPkg, { version: '1.2.3' });
304+
assert.equal(writtenHugoYaml.params.version, '1.2.3');
305+
assert.equal(newVersion, '1.2.3');
306+
assert.deepEqual(messages, [
307+
'✓ Updated version: 1.2.3-dev+build-123 → 1.2.3',
308+
'✓ Updated hugo.yaml version: 1.2.3-dev → 1.2.3',
309+
]);
310+
});
311+
278312
test('main does not update hugo.yaml when using --id', () => {
279313
const pkg = { version: '1.0.0-dev' };
280314
const hugoYaml = { params: { version: '0.9.0' } }; // Different version, but should not be updated

tasks/0.14/commit-inventory.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -4,7 +4,7 @@ date: 2026-01-16
44
cSpell:ignore: docsy frontmatter subrepo
55
---
66

7-
> Report refreshed for commits through `29793a64` on `main`.
7+
> Report refreshed for commits through `37be7dc7` on `main`.
88
99
Chronological list of [commits since v0.13.0][], broadly grouped into a few
1010
categories. We'll do a more detailed analysis and groupings when we create the
@@ -96,7 +96,7 @@ client projects.
9696
- `3753ff78` (#2505) Reorganize SCSS, fix scroll padding, normalize
9797
blocks-shortcode heading IDs and keep old IDs as alias
9898

99-
### Since last refresh (3753ff78..29793a64)
99+
### Since last refresh (3753ff78..37be7dc7)
100100

101101
- `4dc710b4` (#2506) Document heading aliases and in-page targets
102102
- `0ddab73a` (#2508) Improve 0.14.0 upgrade action-step guidance
@@ -132,6 +132,8 @@ client projects.
132132
- `8bc5f537` (#2531) Add cards with thumbnails to examples page, upgrade Hugo to
133133
0.155.3
134134
- `29793a64` (#2533) Add RTL fixes for code blocks and foldable-nav icons
135+
- `617b5960` (#2534) Release 0.14.0 preparation
136+
- `37be7dc7` (#2538) Fix ToC sidebar width in xl viewports
135137

136138
## CI / tooling only
137139

0 commit comments

Comments
 (0)