Skip to content

Commit ad0c3d1

Browse files
pkuczynskiisaacplmann
authored andcommitted
docs(release): add configure changelogs (#23324)
## Current Behavior Documentation is missing ## Expected Behavior Documentation should be there... --------- Co-authored-by: Isaac Mann <[email protected]> (cherry picked from commit 7611671)
1 parent 56b134d commit ad0c3d1

File tree

6 files changed

+150
-0
lines changed

6 files changed

+150
-0
lines changed

docs/generated/manifests/menus.json

Lines changed: 24 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1985,6 +1985,14 @@
19851985
"isExternal": false,
19861986
"children": [],
19871987
"disableCollapsible": false
1988+
},
1989+
{
1990+
"name": "Configure Changelog Format",
1991+
"path": "/recipes/nx-release/configure-changelog-format",
1992+
"id": "configure-changelog-format",
1993+
"isExternal": false,
1994+
"children": [],
1995+
"disableCollapsible": false
19881996
}
19891997
],
19901998
"disableCollapsible": false
@@ -3656,6 +3664,14 @@
36563664
"isExternal": false,
36573665
"children": [],
36583666
"disableCollapsible": false
3667+
},
3668+
{
3669+
"name": "Configure Changelog Format",
3670+
"path": "/recipes/nx-release/configure-changelog-format",
3671+
"id": "configure-changelog-format",
3672+
"isExternal": false,
3673+
"children": [],
3674+
"disableCollapsible": false
36593675
}
36603676
],
36613677
"disableCollapsible": false
@@ -3732,6 +3748,14 @@
37323748
"children": [],
37333749
"disableCollapsible": false
37343750
},
3751+
{
3752+
"name": "Configure Changelog Format",
3753+
"path": "/recipes/nx-release/configure-changelog-format",
3754+
"id": "configure-changelog-format",
3755+
"isExternal": false,
3756+
"children": [],
3757+
"disableCollapsible": false
3758+
},
37353759
{
37363760
"name": "Other",
37373761
"path": "/recipes/other",

docs/generated/manifests/nx.json

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2713,6 +2713,17 @@
27132713
"isExternal": false,
27142714
"path": "/recipes/nx-release/customize-conventional-commit-types",
27152715
"tags": ["nx-release"]
2716+
},
2717+
{
2718+
"id": "configure-changelog-format",
2719+
"name": "Configure Changelog Format",
2720+
"description": "",
2721+
"mediaImage": "",
2722+
"file": "shared/recipes/nx-release/configure-changelog-format",
2723+
"itemList": [],
2724+
"isExternal": false,
2725+
"path": "/recipes/nx-release/configure-changelog-format",
2726+
"tags": ["nx-release"]
27162727
}
27172728
],
27182729
"isExternal": false,
@@ -5004,6 +5015,17 @@
50045015
"isExternal": false,
50055016
"path": "/recipes/nx-release/customize-conventional-commit-types",
50065017
"tags": ["nx-release"]
5018+
},
5019+
{
5020+
"id": "configure-changelog-format",
5021+
"name": "Configure Changelog Format",
5022+
"description": "",
5023+
"mediaImage": "",
5024+
"file": "shared/recipes/nx-release/configure-changelog-format",
5025+
"itemList": [],
5026+
"isExternal": false,
5027+
"path": "/recipes/nx-release/configure-changelog-format",
5028+
"tags": ["nx-release"]
50075029
}
50085030
],
50095031
"isExternal": false,
@@ -5109,6 +5131,17 @@
51095131
"path": "/recipes/nx-release/customize-conventional-commit-types",
51105132
"tags": ["nx-release"]
51115133
},
5134+
"/recipes/nx-release/configure-changelog-format": {
5135+
"id": "configure-changelog-format",
5136+
"name": "Configure Changelog Format",
5137+
"description": "",
5138+
"mediaImage": "",
5139+
"file": "shared/recipes/nx-release/configure-changelog-format",
5140+
"itemList": [],
5141+
"isExternal": false,
5142+
"path": "/recipes/nx-release/configure-changelog-format",
5143+
"tags": ["nx-release"]
5144+
},
51125145
"/recipes/other": {
51135146
"id": "other",
51145147
"name": "Other",

docs/generated/manifests/tags.json

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -532,6 +532,13 @@
532532
"name": "Customize Conventional Commit Types",
533533
"path": "/recipes/nx-release/customize-conventional-commit-types"
534534
},
535+
{
536+
"description": "",
537+
"file": "shared/recipes/nx-release/configure-changelog-format",
538+
"id": "configure-changelog-format",
539+
"name": "Configure Changelog Format",
540+
"path": "/recipes/nx-release/configure-changelog-format"
541+
},
535542
{
536543
"description": "The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.",
537544
"file": "generated/packages/generated/packages/nx/documents/release",

docs/map.json

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1036,6 +1036,12 @@
10361036
"id": "customize-conventional-commit-types",
10371037
"tags": ["nx-release"],
10381038
"file": "shared/recipes/nx-release/customize-conventional-commit-types"
1039+
},
1040+
{
1041+
"name": "Configure Changelog Format",
1042+
"id": "configure-changelog-format",
1043+
"tags": ["nx-release"],
1044+
"file": "shared/recipes/nx-release/configure-changelog-format"
10391045
}
10401046
]
10411047
},
Lines changed: 79 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,79 @@
1+
# Configure Changelog Format
2+
3+
The default changelog renderer for `nx release` generates a changelog entry for each released project similar to the following:
4+
5+
```md
6+
## 7.9.0 (2024-05-13)
7+
8+
### 🚀 Features
9+
10+
- **rule-tester:** check for missing placeholder data in the message ([#9039](https://github.com/typescript-eslint/typescript-eslint/pull/9039))
11+
12+
### ❤️ Thank You
13+
14+
- Kirk Waiblinger
15+
- Sheetal Nandi
16+
- Vinccool96
17+
```
18+
19+
## Include All Metadata
20+
21+
There are a few options available to modify the default changelog renderer output. They can be applied to both `workspaceChangelog` and `projectChangelogs` in exactly the same way. All three options are true by default:
22+
23+
```json
24+
{
25+
"release": {
26+
"changelog": {
27+
"projectChangelogs": {
28+
"renderOptions": {
29+
"authors": true,
30+
"commitReferences": true,
31+
"versionTitleDate": true
32+
}
33+
}
34+
}
35+
}
36+
}
37+
```
38+
39+
#### `authors`
40+
41+
Whether the commit authors should be added to the bottom of the changelog in a "Thank You" section. Defaults to `true`.
42+
43+
#### `commitReferences`
44+
45+
Whether the commit references (such as commit and/or PR links) should be included in the changelog. Defaults to `true`.
46+
47+
#### `versionTitleDate`
48+
49+
Whether to include the date in the version title. It can be set to `false` to disable it, or `true` to enable with the default of (YYYY-MM-DD). Defaults to `true`.
50+
51+
## Remove All Metadata
52+
53+
If you prefer a more minimalist changelog, you can set all the options to false, like this:
54+
55+
```json
56+
{
57+
"release": {
58+
"changelog": {
59+
"projectChangelogs": {
60+
"renderOptions": {
61+
"authors": false,
62+
"commitReferences": false,
63+
"versionTitleDate": false
64+
}
65+
}
66+
}
67+
}
68+
}
69+
```
70+
71+
Which will generate a changelog that looks similar to the following:
72+
73+
```md
74+
## 7.9.0
75+
76+
### 🚀 Features
77+
78+
- **rule-tester:** check for missing placeholder data in the message
79+
```

docs/shared/reference/sitemap.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -162,6 +162,7 @@
162162
- [Publish Rust Crates](/recipes/nx-release/publish-rust-crates)
163163
- [Update Your Local Registry Setup to use Nx Release](/recipes/nx-release/update-local-registry-setup)
164164
- [Customize Conventional Commit Types](/recipes/nx-release/customize-conventional-commit-types)
165+
- [Configure Changelog Format](/recipes/nx-release/configure-changelog-format)
165166
- [Other](/recipes/other)
166167
- [Rescope Packages from @nrwl to @nx](/recipes/other/rescope)
167168
- [Showcase](/showcase)

0 commit comments

Comments
 (0)