From 64166f56bc276ad92b89ebf973259363c6c5b65d Mon Sep 17 00:00:00 2001 From: Bailey Pearson Date: Thu, 18 Sep 2025 09:37:44 -0600 Subject: [PATCH 1/4] Update README.md --- etc/docs/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/etc/docs/README.md b/etc/docs/README.md index 37e0a574bda..1bdacc27412 100644 --- a/etc/docs/README.md +++ b/etc/docs/README.md @@ -14,8 +14,8 @@ necessary to backport a feature). `build.ts` requires the following in addition to dependencies installed with `npm i`: -* Hugo static web generator `v0.30.2` - * You can download the right version [here](https://github.com/gohugoio/hugo/releases/tag/v0.30.2) +* Hugo static web generator `v0.150.0` + * You can download the right version [here](https://github.com/gohugoio/hugo/releases/tag/v0.30.2)](https://github.com/gohugoio/hugo/releases/tag/v0.150.0) * ts-node Note: `typedoc` is also a dependency but it is downloaded by the docs generation script automatically. From 982ff298c3a1a5e2004d40b7b8834c7d17e0b2d5 Mon Sep 17 00:00:00 2001 From: Bailey Pearson Date: Thu, 18 Sep 2025 09:41:06 -0600 Subject: [PATCH 2/4] Update README.md --- etc/docs/README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/etc/docs/README.md b/etc/docs/README.md index 1bdacc27412..9b9e64aa063 100644 --- a/etc/docs/README.md +++ b/etc/docs/README.md @@ -15,7 +15,7 @@ necessary to backport a feature). `build.ts` requires the following in addition to dependencies installed with `npm i`: * Hugo static web generator `v0.150.0` - * You can download the right version [here](https://github.com/gohugoio/hugo/releases/tag/v0.30.2)](https://github.com/gohugoio/hugo/releases/tag/v0.150.0) + * You can download the right version [here](https://github.com/gohugoio/hugo/releases/tag/v0.150.0) * ts-node Note: `typedoc` is also a dependency but it is downloaded by the docs generation script automatically. From b1869ee428482f4121a09cf83acee636fa981775 Mon Sep 17 00:00:00 2001 From: bailey Date: Mon, 22 Sep 2025 14:34:22 -0600 Subject: [PATCH 3/4] enforce hugo version at runtime --- etc/docs/build.ts | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/etc/docs/build.ts b/etc/docs/build.ts index 8989fef950f..cf2c61a4ed2 100755 --- a/etc/docs/build.ts +++ b/etc/docs/build.ts @@ -67,7 +67,6 @@ async function updateSiteTemplateForNewVersion( await writeFile(RELEASES_TOML_FILE, stringify(tomlData as any)); await writeFile(RELEASES_JSON_FILE, JSON.stringify(jsonVersions, null, 4)); - // generate the site from the template await exec(`hugo -s template -d ../temp -b "/node-mongodb-native"`); } @@ -80,6 +79,9 @@ async function main() { process.exit(1); } + const { stdout } = await exec('hugo version', { encoding: 'utf8' }); + if (!stdout.includes('0.150.0')) throw new Error('`hugo` version must be 0.150.0.'); + chdir(__dirname); const { tag, status, skipPrompts } = getCommandLineArguments(); From 2ed702f5a3694315b64c40dc947cf30570761471 Mon Sep 17 00:00:00 2001 From: bailey Date: Mon, 22 Sep 2025 14:35:58 -0600 Subject: [PATCH 4/4] daria's comment --- etc/docs/README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/etc/docs/README.md b/etc/docs/README.md index 9b9e64aa063..9ba9de7bfba 100644 --- a/etc/docs/README.md +++ b/etc/docs/README.md @@ -32,6 +32,8 @@ To generate API documentation for a new major or minor version: `npm run build:docs -- --tag ` +`` should be formatted MAJOR.MINOR (ex. `--tag=6.8`) + You can optionally specify the following options: - `--yes` if set, this will silence any prompts in the script. useful for running in CI