From 9ba362a2b30ceaea2d1dfecda88729ded2d661b3 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= Date: Mon, 25 May 2026 11:46:30 +0200 Subject: [PATCH 1/2] docs: fix invalid minimum dependency age example The example used "72h", which the deno.json parser and the --minimum-dependency-age CLI flag don't accept (only ISO-8601 durations, integer minutes, dates/timestamps, or 0 are valid). The .npmrc setting accepts only an integer number of days. Fixes #3161 --- runtime/fundamentals/modules.md | 19 +++++++++++-------- runtime/fundamentals/node.md | 2 +- 2 files changed, 12 insertions(+), 9 deletions(-) diff --git a/runtime/fundamentals/modules.md b/runtime/fundamentals/modules.md index 7263a691f..73fc66ec0 100644 --- a/runtime/fundamentals/modules.md +++ b/runtime/fundamentals/modules.md @@ -805,27 +805,30 @@ project: ```jsonc title="deno.json" { - "minimumDependencyAge": "72h" + "minimumDependencyAge": "P3D" } ``` - **CLI flag**, apply ad-hoc, e.g. for a one-off install or in a CI step: ```sh - deno install --minimum-dependency-age=72h + deno install --minimum-dependency-age=P3D ``` - **`.npmrc`** (Deno 2.8+), matches the npm convention, useful when sharing the - same `.npmrc` across npm and Deno tooling: + same `.npmrc` across npm and Deno tooling. The npm setting accepts a whole + number of days only: ```ini title=".npmrc" - min-release-age=72h + min-release-age=3 ``` -Values accept human-friendly durations (`72h`, `P2D`), absolute cutoff dates -(`2025-09-16`), or `0` to disable. See -[`.npmrc` configuration](/runtime/fundamentals/node/#npmrc-configuration) for -the other npm-registry options Deno reads. +`deno.json` and `--minimum-dependency-age` accept an +[ISO-8601 duration](https://en.wikipedia.org/wiki/ISO_8601#Durations) such as +`P3D` (3 days) or `PT72H` (72 hours), an integer (interpreted as minutes), an +absolute cutoff date (`2025-09-16`) or RFC3339 timestamp, or `0` to disable. +See [`.npmrc` configuration](/runtime/fundamentals/node/#npmrc-configuration) +for the other npm-registry options Deno reads. ### Typical CI pattern diff --git a/runtime/fundamentals/node.md b/runtime/fundamentals/node.md index 2abeb715b..b1bacd9d7 100644 --- a/runtime/fundamentals/node.md +++ b/runtime/fundamentals/node.md @@ -896,7 +896,7 @@ fields. The ones most likely to matter: for the full picture. ```ini title=".npmrc" - min-release-age=72h + min-release-age=3 ``` - **`NPM_CONFIG_REGISTRY` env var**: overrides the registry set in `.npmrc`, From 7ad3a4c7ba9fbcbc9ad4a509aee362b98ca92789 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Bartek=20Iwa=C5=84czuk?= Date: Mon, 25 May 2026 11:47:48 +0200 Subject: [PATCH 2/2] fmt --- runtime/fundamentals/modules.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/runtime/fundamentals/modules.md b/runtime/fundamentals/modules.md index 73fc66ec0..1fc614b72 100644 --- a/runtime/fundamentals/modules.md +++ b/runtime/fundamentals/modules.md @@ -826,9 +826,9 @@ project: `deno.json` and `--minimum-dependency-age` accept an [ISO-8601 duration](https://en.wikipedia.org/wiki/ISO_8601#Durations) such as `P3D` (3 days) or `PT72H` (72 hours), an integer (interpreted as minutes), an -absolute cutoff date (`2025-09-16`) or RFC3339 timestamp, or `0` to disable. -See [`.npmrc` configuration](/runtime/fundamentals/node/#npmrc-configuration) -for the other npm-registry options Deno reads. +absolute cutoff date (`2025-09-16`) or RFC3339 timestamp, or `0` to disable. See +[`.npmrc` configuration](/runtime/fundamentals/node/#npmrc-configuration) for +the other npm-registry options Deno reads. ### Typical CI pattern