@wtf/release-docs 8.1.0 → 8.2.1

package/api/@wtf/semantic-release-trains/schema/variables/trainsPluginSchema.md

@@ -8,6 +8,6 @@
 
 > `const` **trainsPluginSchema**: [`Validator`](../../../release-system/validator/interfaces/Validator.md)\<[`RootOptions`](../../../release-trains/schema/interfaces/RootOptions.md) & [`TrainsEntryOptions`](../../interfaces/TrainsEntryOptions.md)\>
 
-Defined in: [packages/semantic-release-trains/src/schema.ts:133](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/schema.ts#L133)
+Defined in: [packages/semantic-release-trains/src/schema.ts:184](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/schema.ts#L184)
 
 The validator of the options the plugin is given: the root's, and the entry's own.

package/api/@wtf/semantic-release-trains/type-aliases/PluginSpec.md

@@ -8,7 +8,7 @@
 
 > **PluginSpec** = `string` \| readonly \[`string`\] \| readonly \[`string`, `Readonly`\<`Record`\<`string`, `unknown`\>\>\]
 
-Defined in: [packages/semantic-release-trains/src/types.ts:15](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/types.ts#L15)
+Defined in: [packages/semantic-release-trains/src/types.ts:15](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/types.ts#L15)
 
 A plugin, as an entry of `plugins` names one: its name, as `'@semantic-release/commit-analyzer'`,
 or its name and its options, as `['@semantic-release/commit-analyzer', { preset:

package/api/@wtf/semantic-release-trains/type-aliases/TrainsPluginOptions.md

@@ -8,6 +8,6 @@
 
 > **TrainsPluginOptions** = [`TrainsOptions`](../interfaces/TrainsOptions.md) & [`TrainsEntryOptions`](../interfaces/TrainsEntryOptions.md)
 
-Defined in: [packages/semantic-release-trains/src/types.ts:71](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/types.ts#L71)
+Defined in: [packages/semantic-release-trains/src/types.ts:96](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/types.ts#L96)
 
 The options the plugin is given: the root's, and the entry's own.

package/api/@wtf/semantic-release-trains/variables/addChannel.md

@@ -8,6 +8,6 @@
 
 > `const` **addChannel**: `Step` = `plugin.addChannel`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:69](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L69)
+Defined in: [packages/semantic-release-trains/src/index.ts:69](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L69)
 
 The wrapped plugin's `addChannel`, of the train's commits: `false` of an entry of none.

package/api/@wtf/semantic-release-trains/variables/analyzeCommits.md

@@ -8,6 +8,6 @@
 
 > `const` **analyzeCommits**: `Step` = `plugin.analyzeCommits`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:59](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L59)
+Defined in: [packages/semantic-release-trains/src/index.ts:59](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L59)
 
 The wrapped plugin's `analyzeCommits`, of the train's commits, after the rule `dependencies`.

package/api/@wtf/semantic-release-trains/variables/default.md

@@ -8,7 +8,7 @@
 
 > **default**: `object`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L76)
+Defined in: [packages/semantic-release-trains/src/index.ts:76](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L76)
 
 The plugin: every step of semantic-release, each of the role of its entry.
 

package/api/@wtf/semantic-release-trains/variables/fail.md

@@ -8,6 +8,6 @@
 
 > `const` **fail**: `Step` = `plugin.fail`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:73](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L73)
+Defined in: [packages/semantic-release-trains/src/index.ts:73](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L73)
 
 The wrapped plugin's `fail`, of the train's commits.

package/api/@wtf/semantic-release-trains/variables/generateNotes.md

@@ -8,6 +8,6 @@
 
 > `const` **generateNotes**: `Step` = `plugin.generateNotes`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:63](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L63)
+Defined in: [packages/semantic-release-trains/src/index.ts:63](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L63)
 
 The wrapped plugin's `generateNotes`, of the train's commits: `''` of an entry of none.

package/api/@wtf/semantic-release-trains/variables/prepare.md

@@ -8,6 +8,6 @@
 
 > `const` **prepare**: `Step` = `plugin.prepare`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:65](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L65)
+Defined in: [packages/semantic-release-trains/src/index.ts:65](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L65)
 
 The train's generated folders staged, of `generated`; the wrapped plugin's `prepare`.

package/api/@wtf/semantic-release-trains/variables/publish.md

@@ -8,6 +8,6 @@
 
 > `const` **publish**: `Step` = `plugin.publish`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:67](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L67)
+Defined in: [packages/semantic-release-trains/src/index.ts:67](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L67)
 
 The wrapped plugin's `publish`, of the train's commits: `false` of an entry of none.

package/api/@wtf/semantic-release-trains/variables/success.md

@@ -8,6 +8,6 @@
 
 > `const` **success**: `Step` = `plugin.success`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:71](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L71)
+Defined in: [packages/semantic-release-trains/src/index.ts:71](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L71)
 
 The wrapped plugin's `success`, of the train's commits.

package/api/@wtf/semantic-release-trains/variables/verifyConditions.md

@@ -8,6 +8,6 @@
 
 > `const` **verifyConditions**: `Step` = `plugin.verifyConditions`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L57)
+Defined in: [packages/semantic-release-trains/src/index.ts:57](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L57)
 
 Each entry's check of the trains, and the wrapped plugin's `verifyConditions`.

package/api/@wtf/semantic-release-trains/variables/verifyRelease.md

@@ -8,6 +8,6 @@
 
 > `const` **verifyRelease**: `Step` = `plugin.verifyRelease`
 
-Defined in: [packages/semantic-release-trains/src/index.ts:61](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-trains/src/index.ts#L61)
+Defined in: [packages/semantic-release-trains/src/index.ts:61](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-trains/src/index.ts#L61)
 
 The wrapped plugin's `verifyRelease`, of the train's commits.

package/api/@wtf/semantic-release-validate/functions/configOf.md

@@ -8,7 +8,7 @@
 
 > **configOf**(`options`): `Record`\<`string`, `unknown`\>
 
-Defined in: [packages/semantic-release-validate/src/index.ts:83](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/index.ts#L83)
+Defined in: [packages/semantic-release-validate/src/index.ts:83](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/index.ts#L83)
 
 The config of a run as it was written, of the options semantic-release gives a plugin in
 `context.options`, which are the config, with its defaults, and what semantic-release adds:

package/api/@wtf/semantic-release-validate/functions/loadSchema.md

@@ -8,7 +8,7 @@
 
 > **loadSchema**(`spec`, `cwd`): `Promise`\<`StandardSchemaV1`\<`unknown`, `unknown`\>\>
 
-Defined in: [packages/semantic-release-validate/src/index.ts:113](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/index.ts#L113)
+Defined in: [packages/semantic-release-validate/src/index.ts:113](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/index.ts#L113)
 
 The schema of `spec`: a Standard Schema itself, or the default export of a module, by its path
 from `cwd` or the name of a package the repo installs. Throws `ESCHEMA` of one that cannot be

package/api/@wtf/semantic-release-validate/functions/verifyConditions.md

@@ -8,7 +8,7 @@
 
 > **verifyConditions**(`pluginConfig`, `context`): `Promise`\<`void`\>
 
-Defined in: [packages/semantic-release-validate/src/index.ts:160](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/index.ts#L160)
+Defined in: [packages/semantic-release-validate/src/index.ts:160](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/index.ts#L160)
 
 Validates the config of the run, as it was written ([configOf](configOf.md)), `plugins` too, by the
 plugin's `schema`: its own options first (`EOPTIONS` of its `./schema`), then the config, each

package/api/@wtf/semantic-release-validate/interfaces/ValidatePluginOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: ValidatePluginOptions
 
-Defined in: [packages/semantic-release-validate/src/index.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/index.ts#L42)
+Defined in: [packages/semantic-release-validate/src/index.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/index.ts#L42)
 
 The options of the plugin.
 
@@ -16,7 +16,7 @@ The options of the plugin.
 
 > `readonly` **schema**: `string` \| `StandardSchemaV1`\<`unknown`, `unknown`\>
 
-Defined in: [packages/semantic-release-validate/src/index.ts:47](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/index.ts#L47)
+Defined in: [packages/semantic-release-validate/src/index.ts:47](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/index.ts#L47)
 
 The schema the config satisfies: a Standard Schema, or a module whose default export is one, by
 its path from the root of the repo or the name of a package.

package/api/@wtf/semantic-release-validate/schema/interfaces/Validator.md

@@ -6,7 +6,7 @@
 
 # Interface: Validator
 
-Defined in: [packages/semantic-release-validate/src/schema.ts:13](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/schema.ts#L13)
+Defined in: [packages/semantic-release-validate/src/schema.ts:13](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/schema.ts#L13)
 
 A validator of this package: a Standard Schema, and a Standard JSON Schema of draft 2020-12.
 
@@ -16,6 +16,6 @@ A validator of this package: a Standard Schema, and a Standard JSON Schema of dr
 
 > `readonly` **~standard**: `Props`\<`unknown`, `unknown`\> & `Props`\<`unknown`, `unknown`\>
 
-Defined in: [packages/semantic-release-validate/src/schema.ts:15](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/schema.ts#L15)
+Defined in: [packages/semantic-release-validate/src/schema.ts:15](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/schema.ts#L15)
 
 The properties of both standards.

package/api/@wtf/semantic-release-validate/schema/variables/configSchema.md

@@ -8,6 +8,6 @@
 
 > `const` **configSchema**: [`Validator`](../interfaces/Validator.md)
 
-Defined in: [packages/semantic-release-validate/src/schema.ts:118](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/schema.ts#L118)
+Defined in: [packages/semantic-release-validate/src/schema.ts:118](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/schema.ts#L118)
 
 The validator of this package's part of a whole config: each entry of `plugins` of the plugin.

package/api/@wtf/semantic-release-validate/schema/variables/jsonSchema.md

@@ -8,6 +8,6 @@
 
 > `const` **jsonSchema**: `Readonly`\<`Record`\<`string`, `unknown`\>\>
 
-Defined in: [packages/semantic-release-validate/src/schema.ts:121](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/schema.ts#L121)
+Defined in: [packages/semantic-release-validate/src/schema.ts:121](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/schema.ts#L121)
 
 The JSON Schema of [configSchema](configSchema.md), as the package publishes it, `schema.json`.

package/api/@wtf/semantic-release-validate/schema/variables/validateOptionsSchema.md

@@ -8,6 +8,6 @@
 
 > `const` **validateOptionsSchema**: [`Validator`](../interfaces/Validator.md)
 
-Defined in: [packages/semantic-release-validate/src/schema.ts:113](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/schema.ts#L113)
+Defined in: [packages/semantic-release-validate/src/schema.ts:113](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/schema.ts#L113)
 
 The validator of the options of an entry of the plugin: `schema`, required.

package/api/@wtf/semantic-release-validate/variables/default.md

@@ -8,7 +8,7 @@
 
 > **default**: `object`
 
-Defined in: [packages/semantic-release-validate/src/index.ts:181](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/semantic-release-validate/src/index.ts#L181)
+Defined in: [packages/semantic-release-validate/src/index.ts:181](https://gitlab.com/wetryfun/release/release/-/blob/be2016d6f7c6f29592926b2f125da705da6376eb/packages/semantic-release-validate/src/index.ts#L181)
 
 ## Type Declaration
 

package/api/README.md

@@ -14,6 +14,21 @@
 - [@wtf/release-cargo/publish](@wtf/release-cargo/publish/README.md)
 - [@wtf/release-cargo/registry](@wtf/release-cargo/registry/README.md)
 - [@wtf/release-cargo/stamp](@wtf/release-cargo/stamp/README.md)
+- [@wtf/release-go](@wtf/release-go/README.md)
+- [@wtf/release-go/ecosystem](@wtf/release-go/ecosystem/README.md)
+- [@wtf/release-go/errors](@wtf/release-go/errors/README.md)
+- [@wtf/release-go/gomod](@wtf/release-go/gomod/README.md)
+- [@wtf/release-go/modules](@wtf/release-go/modules/README.md)
+- [@wtf/release-go/stamp](@wtf/release-go/stamp/README.md)
+- [@wtf/release-go/tags](@wtf/release-go/tags/README.md)
+- [@wtf/release-maven](@wtf/release-maven/README.md)
+- [@wtf/release-maven/artifacts](@wtf/release-maven/artifacts/README.md)
+- [@wtf/release-maven/ecosystem](@wtf/release-maven/ecosystem/README.md)
+- [@wtf/release-maven/errors](@wtf/release-maven/errors/README.md)
+- [@wtf/release-maven/pom](@wtf/release-maven/pom/README.md)
+- [@wtf/release-maven/publish](@wtf/release-maven/publish/README.md)
+- [@wtf/release-maven/repository](@wtf/release-maven/repository/README.md)
+- [@wtf/release-maven/stamp](@wtf/release-maven/stamp/README.md)
 - [@wtf/release-npm](@wtf/release-npm/README.md)
 - [@wtf/release-npm/check](@wtf/release-npm/check/README.md)
 - [@wtf/release-npm/ecosystem](@wtf/release-npm/ecosystem/README.md)
@@ -38,9 +53,6 @@
 - [@wtf/release-system/system](@wtf/release-system/system/README.md)
 - [@wtf/release-system/validator](@wtf/release-system/validator/README.md)
 - [@wtf/release-trains](@wtf/release-trains/README.md)
-- [@wtf/release-trains-changelog](@wtf/release-trains-changelog/README.md)
-- [@wtf/release-trains-changelog/render](@wtf/release-trains-changelog/render/README.md)
-- [@wtf/release-trains-changelog/write](@wtf/release-trains-changelog/write/README.md)
 - [@wtf/release-trains/cascade](@wtf/release-trains/cascade/README.md)
 - [@wtf/release-trains/ecosystem](@wtf/release-trains/ecosystem/README.md)
 - [@wtf/release-trains/errors](@wtf/release-trains/errors/README.md)
@@ -57,14 +69,17 @@
 - [@wtf/release-validate/validate](@wtf/release-validate/validate/README.md)
 - [@wtf/semantic-release-cargo](@wtf/semantic-release-cargo/README.md)
 - [@wtf/semantic-release-cargo/schema](@wtf/semantic-release-cargo/schema/README.md)
+- [@wtf/semantic-release-go](@wtf/semantic-release-go/README.md)
+- [@wtf/semantic-release-go/schema](@wtf/semantic-release-go/schema/README.md)
+- [@wtf/semantic-release-maven](@wtf/semantic-release-maven/README.md)
+- [@wtf/semantic-release-maven/schema](@wtf/semantic-release-maven/schema/README.md)
 - [@wtf/semantic-release-npm](@wtf/semantic-release-npm/README.md)
 - [@wtf/semantic-release-npm/schema](@wtf/semantic-release-npm/schema/README.md)
 - [@wtf/semantic-release-replace](@wtf/semantic-release-replace/README.md)
 - [@wtf/semantic-release-replace/schema](@wtf/semantic-release-replace/schema/README.md)
 - [@wtf/semantic-release-trains](@wtf/semantic-release-trains/README.md)
-- [@wtf/semantic-release-trains-changelog](@wtf/semantic-release-trains-changelog/README.md)
-- [@wtf/semantic-release-trains-changelog/schema](@wtf/semantic-release-trains-changelog/schema/README.md)
 - [@wtf/semantic-release-trains/config](@wtf/semantic-release-trains/config/README.md)
+- [@wtf/semantic-release-trains/defaults](@wtf/semantic-release-trains/defaults/README.md)
 - [@wtf/semantic-release-trains/errors](@wtf/semantic-release-trains/errors/README.md)
 - [@wtf/semantic-release-trains/info](@wtf/semantic-release-trains/info/README.md)
 - [@wtf/semantic-release-trains/schema](@wtf/semantic-release-trains/schema/README.md)

package/api/trains.json

@@ -5,9 +5,7 @@
     ],
     "trains": [
       "@wtf/release-trains",
-      "@wtf/release-trains-changelog",
-      "@wtf/semantic-release-trains",
-      "@wtf/semantic-release-trains-changelog"
+      "@wtf/semantic-release-trains"
     ],
     "npm": [
       "@wtf/release-npm",
@@ -25,6 +23,14 @@
       "@wtf/release-cargo",
       "@wtf/semantic-release-cargo"
     ],
+    "go": [
+      "@wtf/release-go",
+      "@wtf/semantic-release-go"
+    ],
+    "maven": [
+      "@wtf/release-maven",
+      "@wtf/semantic-release-maven"
+    ],
     "docs": [
       "@wtf/release-docs"
     ]

package/guides/changelogs.md

@@ -1,16 +1,19 @@
 # Changelogs
 
-By default a train has one changelog, which `@semantic-release/changelog` writes from the notes of
-the release. `@wtf/semantic-release-trains-changelog` writes one changelog for each package of the
-train, from the commits that change the folder of that package:
+Each train has its own changelog, written by `@semantic-release/changelog` from the notes of the
+release. The trains plugin that wraps the release notes generator gives it the train's commits
+alone, so the notes, and the changelog, are of that train. Wrap the changelog plugin too, and the
+train gives it its file and title: the train's `changelog`, or the `CHANGELOG.md` of its first
+path, under `# Changelog`. Wrap `@semantic-release/git`, and the train gives it the assets of its
+release commit, the changelog among them, and a message of its name:
 
 ```js train=trains
 // release.config.mjs
-import { BREAKING, trainAssets, trainTagFormat } from '@wtf/semantic-release-trains/config'
+import { BREAKING, trainTagFormat } from '@wtf/semantic-release-trains/config'
 
 const trains = {
   trains: {
-    paths: ['packages/release-trains', 'packages/release-trains-*'],
+    paths: ['packages/release-trains', 'packages/semantic-release-trains'],
     changelog: 'CHANGELOG-trains.md'
   }
 }
@@ -24,84 +27,30 @@ export default {
   plugins: [
     ['@wtf/semantic-release-trains', { wrap: '@semantic-release/commit-analyzer' }],
     ['@wtf/semantic-release-trains', { wrap: '@semantic-release/release-notes-generator' }],
-    ['@wtf/semantic-release-trains-changelog', { trainChangelog: 'CHANGELOG-trains.md' }],
-    [
-      '@semantic-release/git',
-      { assets: trainAssets(trains, train, { changelogs: 'CHANGELOG.md' }) }
-    ]
+    // CHANGELOG-trains.md, under `# Changelog`.
+    ['@wtf/semantic-release-trains', { wrap: '@semantic-release/changelog' }],
+    // The changelog and the generated folders, in `chore(release): trains <version>`.
+    ['@wtf/semantic-release-trains', { wrap: '@semantic-release/git' }]
   ]
 }
 ```
 
-In the `prepare` step, before the release commit, the plugin writes:
-
-- for each package of the train, the section of the release at the top of `<package>/CHANGELOG.md`,
-  with only the commits that change the folder of the package. A package that no commit of the
-  release changes gets no section;
-- of `trainChangelog`, the section of all the commits of the train in that file. The file of the
-  train cannot be the changelog of one of its packages (`ECHANGELOG`).
-
-`trainAssets` of `@wtf/semantic-release-trains/config`, with `changelogs`, gives
-`@semantic-release/git` the changelogs to commit.
-
-With `file: false`, it writes the train's changelog alone, and no package gets one, as
-`@semantic-release/changelog` does, but a release run again, after a publish that failed, adds no
-section twice. Give it `trainChangelog`, or it has nothing to write (`ECHANGELOG`). Of one train
-of every package, as this repo releases:
-
-```js train=release
-// release.config.mjs
-import { BREAKING, trainAssets } from '@wtf/semantic-release-trains/config'
-
-const trains = { release: { paths: ['packages/*'], changelog: 'CHANGELOG.md' } }
-
-export default {
-  trains,
-  ecosystems: ['@wtf/semantic-release-npm/ecosystem'],
-  train: 'release',
-  tagFormat: 'v${version}',
-  ...BREAKING,
-  plugins: [
-    '@semantic-release/commit-analyzer',
-    '@semantic-release/release-notes-generator',
-    ['@wtf/semantic-release-trains-changelog', { file: false, trainChangelog: 'CHANGELOG.md' }],
-    // With no `changelogs`, the train's changelog alone.
-    ['@semantic-release/git', { assets: trainAssets(trains, 'release') }]
-  ]
-}
-```
-
-A section groups the commits by type. The breaking changes come first:
-
-```md
-## 2.0.0 (2026-10-30)
-
-### BREAKING CHANGES
-
-- **release-trains:** Node 24 is the least. ([c1b2c3d](https://gitlab.com/wetryfun/release/release/-/commit/c1b2c3d…))
+A release run again, after a publish that failed part way, writes no section twice: the wrapped
+changelog plugin skips its `prepare` by the rule `section`, when the changelog has a heading of the
+release already, the first heading of the notes of any date. The stock plugin alone writes it
+again. `skip: { prepare: false }` turns it off; see
+[skipping a step](../../semantic-release-trains/README.md#skipping-a-step) for the rule of any step.
 
-### Features
+An option the config gives a wrapped plugin wins over the train's: `wrap:
+['@semantic-release/changelog', { changelogFile: 'docs/CHANGES.md' }]`. Listed unwrapped, the
+plugins take what the config gives them: `trainChangelog`, `TITLE` and `trainAssets` of
+`@wtf/semantic-release-trains/config` give the same values to pass by hand.
 
-- **release-npm:** the smoke of every package packed ([a1b2c3d](https://gitlab.com/wetryfun/release/release/-/commit/a1b2c3d…))
-- **release-trains:** drop Node 22 ([c1b2c3d](https://gitlab.com/wetryfun/release/release/-/commit/c1b2c3d…))
-
-### Bug Fixes
-
-- mend the order of the publish ([b1b2c3d](https://gitlab.com/wetryfun/release/release/-/commit/b1b2c3d…))
-```
-
-A breaking change is a commit with a `BREAKING CHANGE:` footer, whose text it shows, or with a `!`
-after its type, whose subject it shows. Give each breaking commit the footer: see
+The changelog plugin reads the notes, not the commits: the entry that wraps it is for its options.
+A preset of the notes generator decides how a section looks: its types, their headings, and the breaking changes
+first. Give each breaking commit a `BREAKING CHANGE:` footer as well as its `!`: see
 [the caveat](configuring-trains.md#a-preset-and-type).
 
-| Option           | Default                        | What it is                                                       |
-| ---------------- | ------------------------------ | ---------------------------------------------------------------- |
-| `file`           | `CHANGELOG.md`                 | The changelog of each package, in its folder, or `false`.        |
-| `title`          | `# Changelog`                  | The title of each changelog.                                     |
-| `types`          | features, fixes, perf, reverts | The types that a section shows, each with its heading, in order. |
-| `repositoryUrl`  | the run's                      | The repository whose commit pages each line links to.            |
-| `trainChangelog` | none                           | The changelog of the train, of all its commits.                  |
-
 ## The train in the heading
 
 The notes of a release are headed by its version alone: `## [4.0.0](…) (2026-11-02)`, as the
@@ -125,6 +74,7 @@ each train's own: a second `@semantic-release/changelog` writes the same notes a
 // release.config.mjs
 import {
   BREAKING,
+  TITLE,
   trainAssets,
   trainChangelog,
   trainTagFormat
@@ -148,55 +98,12 @@ export default {
       { wrap: '@semantic-release/release-notes-generator', heading: 'train' }
     ],
     // The train's own changelog, then the changelog of every train.
-    ['@semantic-release/changelog', { changelogFile: trainChangelog(trains, train) }],
-    ['@semantic-release/changelog', { changelogFile: 'CHANGELOG.md' }],
+    [
+      '@semantic-release/changelog',
+      { changelogFile: trainChangelog(trains, train), changelogTitle: TITLE }
+    ],
+    ['@semantic-release/changelog', { changelogFile: 'CHANGELOG.md', changelogTitle: TITLE }],
     ['@semantic-release/git', { assets: [...trainAssets(trains, train), 'CHANGELOG.md'] }]
   ]
 }
 ```
-
-## As a library
-
-`@wtf/release-trains-changelog` is the library the plugin runs, of no release tool. `./write`
-writes the changelogs of a release, by the `system` its caller gives it, as a CLI passes its own:
-
-```ts
-import npm from '@wtf/release-npm'
-import type { System } from '@wtf/release-system/system'
-import { writeChangelogs } from '@wtf/release-trains-changelog/write'
-
-export function writeTrains(system: System, commits: { hash: string; message: string }[]) {
-  return writeChangelogs({
-    trains: { trains: { paths: ['packages/release-trains', 'packages/release-trains-*'] } },
-    train: 'trains',
-    // The packages of each train, of each package.json, as the ecosystem of npm reads them.
-    ecosystems: [npm],
-    version: '1.2.0',
-    commits,
-    system
-  })
-}
-```
-
-`./render` renders and reads sections, with no git and no system:
-
-```ts
-import {
-  changelogSection,
-  prependSection,
-  renderSection
-} from '@wtf/release-trains-changelog/render'
-
-const section = renderSection(
-  [
-    { hash: 'a1b2c3d4e5f6', message: 'feat(semantic-release-trains): the option cascade' },
-    { hash: 'b1b2c3d4e5f6', message: 'chore: tidy' }
-  ],
-  { version: '1.2.0', date: '2026-10-30', types: [['feat', 'Features']] }
-)
-const changelog = prependSection('# Changelog\n\n## 1.1.0 (2026-10-01)\n\n- older\n', section)
-
-export const latest = changelogSection(changelog, '1.2.0') // the section of 1.2.0, to the next heading
-```
-
-`changelogSection` also reads the headings of `@semantic-release/changelog`.

package/guides/ci-recipes.md

@@ -347,30 +347,33 @@ version outside a range that its last release published releases too, of no comm
 
 ```js train=docs
 // release.config.mjs
+import { trainChangelog } from '@wtf/semantic-release-trains/config'
+
+const trains = {
+  system: { paths: ['packages/release-system'] },
+  trains: { paths: ['packages/release-trains', 'packages/semantic-release-trains'] },
+  replace: { paths: ['packages/release-replace', 'packages/semantic-release-replace'] },
+  validate: { paths: ['packages/release-validate', 'packages/semantic-release-validate'] },
+  docs: {
+    paths: ['packages/docs'],
+    generated: ['packages/docs/api'],
+    // Say the docs package lists none of the packages it documents: it releases after them.
+    dependsOn: ['system', 'trains', 'replace', 'validate']
+  }
+}
 const train = process.env.RELEASE_TRAIN
 const docs = train === 'docs'
 
 export default {
   ecosystems: ['@wtf/semantic-release-npm/ecosystem'],
-  trains: {
-    system: { paths: ['packages/release-system'] },
-    trains: { paths: ['packages/release-trains', 'packages/semantic-release-trains'] },
-    replace: { paths: ['packages/release-replace', 'packages/semantic-release-replace'] },
-    validate: { paths: ['packages/release-validate', 'packages/semantic-release-validate'] },
-    docs: {
-      paths: ['packages/docs'],
-      generated: ['packages/docs/api'],
-      // Say the docs package lists none of the packages it documents: it releases after them.
-      dependsOn: ['system', 'trains', 'replace', 'validate']
-    }
-  },
+  trains,
   tagFormat: `${train}-v\${version}`,
   parserOpts: { breakingHeaderPattern: '^(\\w*)(?:\\((.*)\\))?!: (.*)$' },
   dependencies: 'fail',
   plugins: [
     ['@wtf/semantic-release-trains', { wrap: '@semantic-release/commit-analyzer' }],
     ['@wtf/semantic-release-trains', { wrap: '@semantic-release/release-notes-generator' }],
-    '@wtf/semantic-release-trains-changelog',
+    ['@semantic-release/changelog', { changelogFile: trainChangelog(trains, train) }],
     // The reference of docs, built and staged: the plugins of no other train's run.
     ...(docs
       ? [

package/guides/configuring-trains.md

@@ -244,6 +244,7 @@ URL; one that cannot be loaded, or whose default export is no ecosystem, fails w
 import {
   BRANCHES,
   BREAKING,
+  TITLE,
   trainAssets,
   trainChangelog,
   trainTagFormat
@@ -278,15 +279,17 @@ export default {
       '@wtf/semantic-release-trains',
       { wrap: ['@semantic-release/release-notes-generator', { preset: 'conventionalcommits' }] }
     ],
-    // The changelog of each package, and of the train, each of no section twice: a release run
-    // again after a publish that failed writes none again.
-    ['@wtf/semantic-release-trains-changelog', { trainChangelog: trainChangelog(trains, train) }],
+    // The changelog of the train, of the notes of the train's commits.
+    [
+      '@semantic-release/changelog',
+      { changelogFile: trainChangelog(trains, train), changelogTitle: TITLE }
+    ],
     '@wtf/semantic-release-npm',
     ['@wtf/semantic-release-trains', { generated: true }],
     [
       '@semantic-release/git',
       {
-        assets: trainAssets(trains, train, { changelogs: 'CHANGELOG.md' }),
+        assets: trainAssets(trains, train),
         message: `chore(release): ${train} \${nextRelease.version}`
       }
     ],