Skip to content

Commit 4b9aab7

Browse files
committed
docs: update API documentation
1 parent 52f2c4e commit 4b9aab7

7 files changed

Lines changed: 107 additions & 15 deletions

websites/api.rushstack.io/data/api_nav.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -4778,6 +4778,11 @@
47784778
"label": "rushAlerts",
47794779
"id": "pages/rush-lib.iexperimentsjson.rushalerts"
47804780
},
4781+
{
4782+
"type": "doc",
4783+
"label": "strictChangefileValidation",
4784+
"id": "pages/rush-lib.iexperimentsjson.strictchangefilevalidation"
4785+
},
47814786
{
47824787
"type": "doc",
47834788
"label": "useIPCScriptsInWatchMode",
@@ -6422,6 +6427,11 @@
64226427
"label": "minimumReleaseAgeExclude",
64236428
"id": "pages/rush-lib.pnpmoptionsconfiguration.minimumreleaseageexclude"
64246429
},
6430+
{
6431+
"type": "doc",
6432+
"label": "minimumReleaseAgeMinutes",
6433+
"id": "pages/rush-lib.pnpmoptionsconfiguration.minimumreleaseageminutes"
6434+
},
64256435
{
64266436
"type": "doc",
64276437
"label": "pnpmLockfilePolicies",

websites/api.rushstack.io/docs/pages/rush-lib.iexperimentsjson.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -290,6 +290,25 @@ boolean
290290
**_(BETA)_** _(Optional)_ (UNDER DEVELOPMENT) The Rush alerts feature provides a way to send announcements to engineers working in the monorepo, by printing directly in the user's shell window when they invoke Rush commands. This ensures that important notices will be seen by anyone doing active development, since people often ignore normal discussion group messages or don't know to subscribe.
291291

292292

293+
</td></tr>
294+
<tr><td>
295+
296+
[strictChangefileValidation?](./rush-lib.iexperimentsjson.strictchangefilevalidation.md)
297+
298+
299+
</td><td>
300+
301+
302+
</td><td>
303+
304+
boolean
305+
306+
307+
</td><td>
308+
309+
**_(BETA)_** _(Optional)_ If true, `rush change --verify` will perform additional validation of change files. Specifically, it will report errors if change files reference projects that do not exist in the Rush configuration, or if change files target a project that belongs to a lockstepped version policy but is not the policy's main project.
310+
311+
293312
</td></tr>
294313
<tr><td>
295314

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,22 @@
1+
---
2+
hide_title: true
3+
custom_edit_url: null
4+
pagination_prev: null
5+
pagination_next: null
6+
---
7+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
8+
9+
[Home](./index.md) &gt; [@microsoft/rush-lib](./rush-lib.md) &gt; [IExperimentsJson](./rush-lib.iexperimentsjson.md) &gt; [strictChangefileValidation](./rush-lib.iexperimentsjson.strictchangefilevalidation.md)
10+
11+
## IExperimentsJson.strictChangefileValidation property
12+
13+
> This API is provided as a beta preview for developers and may change based on feedback that we receive. Do not use this API in a production environment.
14+
>
15+
16+
If true, `rush change --verify` will perform additional validation of change files. Specifically, it will report errors if change files reference projects that do not exist in the Rush configuration, or if change files target a project that belongs to a lockstepped version policy but is not the policy's main project.
17+
18+
**Signature:**
19+
20+
```typescript
21+
strictChangefileValidation?: boolean;
22+
```

websites/api.rushstack.io/docs/pages/rush-lib.pnpmoptionsconfiguration.md

Lines changed: 22 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -370,8 +370,6 @@ number \| undefined
370370
371371
</td><td>
372372
373-
The minimum number of minutes that must pass after a version is published before pnpm will install it. This setting helps reduce the risk of installing compromised packages, as malicious releases are typically discovered and removed within a short time frame.
374-
375373
376374
</td></tr>
377375
<tr><td>
@@ -391,7 +389,28 @@ string\[\] \| undefined
391389
392390
</td><td>
393391
394-
List of package names or patterns that are excluded from the minimumReleaseAge check. These packages will always install the newest version immediately, even if minimumReleaseAge is set.
392+
List of package names or patterns that are excluded from the minimumReleaseAge check. These packages will always install the newest version immediately, even if minimumReleaseAgeMinutes is set.
393+
394+
395+
</td></tr>
396+
<tr><td>
397+
398+
[minimumReleaseAgeMinutes](./rush-lib.pnpmoptionsconfiguration.minimumreleaseageminutes.md)
399+
400+
401+
</td><td>
402+
403+
`readonly`
404+
405+
406+
</td><td>
407+
408+
number \| undefined
409+
410+
411+
</td><td>
412+
413+
The minimum number of minutes that must pass after a version is published before pnpm will install it. This setting helps reduce the risk of installing compromised packages, as malicious releases are typically discovered and removed within a short time frame.
395414
396415
397416
</td></tr>

websites/api.rushstack.io/docs/pages/rush-lib.pnpmoptionsconfiguration.minimumreleaseage.md

Lines changed: 5 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -10,19 +10,13 @@ pagination_next: null
1010

1111
## PnpmOptionsConfiguration.minimumReleaseAge property
1212

13-
The minimum number of minutes that must pass after a version is published before pnpm will install it. This setting helps reduce the risk of installing compromised packages, as malicious releases are typically discovered and removed within a short time frame.
13+
> Warning: This API is now obsolete.
14+
>
15+
> Use [PnpmOptionsConfiguration.minimumReleaseAgeMinutes](./rush-lib.pnpmoptionsconfiguration.minimumreleaseageminutes.md) instead.
16+
>
1417
1518
**Signature:**
1619

1720
```typescript
18-
readonly minimumReleaseAge: number | undefined;
21+
get minimumReleaseAge(): number | undefined;
1922
```
20-
21-
## Remarks
22-
23-
(SUPPORTED ONLY IN PNPM 10.16.0 AND NEWER)
24-
25-
PNPM documentation: https://pnpm.io/settings\#minimumreleaseage
26-
27-
The default value is 0 (disabled).
28-

websites/api.rushstack.io/docs/pages/rush-lib.pnpmoptionsconfiguration.minimumreleaseageexclude.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ pagination_next: null
1010

1111
## PnpmOptionsConfiguration.minimumReleaseAgeExclude property
1212

13-
List of package names or patterns that are excluded from the minimumReleaseAge check. These packages will always install the newest version immediately, even if minimumReleaseAge is set.
13+
List of package names or patterns that are excluded from the minimumReleaseAge check. These packages will always install the newest version immediately, even if minimumReleaseAgeMinutes is set.
1414

1515
**Signature:**
1616

Lines changed: 28 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,28 @@
1+
---
2+
hide_title: true
3+
custom_edit_url: null
4+
pagination_prev: null
5+
pagination_next: null
6+
---
7+
<!-- Do not edit this file. It is automatically generated by API Documenter. -->
8+
9+
[Home](./index.md) &gt; [@microsoft/rush-lib](./rush-lib.md) &gt; [PnpmOptionsConfiguration](./rush-lib.pnpmoptionsconfiguration.md) &gt; [minimumReleaseAgeMinutes](./rush-lib.pnpmoptionsconfiguration.minimumreleaseageminutes.md)
10+
11+
## PnpmOptionsConfiguration.minimumReleaseAgeMinutes property
12+
13+
The minimum number of minutes that must pass after a version is published before pnpm will install it. This setting helps reduce the risk of installing compromised packages, as malicious releases are typically discovered and removed within a short time frame.
14+
15+
**Signature:**
16+
17+
```typescript
18+
readonly minimumReleaseAgeMinutes: number | undefined;
19+
```
20+
21+
## Remarks
22+
23+
(SUPPORTED ONLY IN PNPM 10.16.0 AND NEWER)
24+
25+
PNPM documentation: https://pnpm.io/settings\#minimumreleaseage
26+
27+
The default value is 0 (disabled).
28+

0 commit comments

Comments
 (0)