@wtf/release-docs 8.1.0 → 8.2.1

package/guides/system.md

@@ -1,7 +1,7 @@
 # The system
 
-Every function of the libraries, `@wtf/release-trains`, `@wtf/release-trains-changelog`,
-`@wtf/release-npm` and `@wtf/release-replace`, does its work outside itself through a
+Every function of the libraries, `@wtf/release-trains`, `@wtf/release-npm` and
+`@wtf/release-replace`, does its work outside itself through a
 `System` of `@wtf/release-system`, the base they build on, which it requires and never makes of its
 own: files, processes, the environment, the working folder, a folder of
 temporary files, and the clock. None of their modules names Node. A plugin of semantic-release

package/guides/validating-a-config.md

@@ -3,14 +3,13 @@
 Each package owns one part of a config of semantic-release, and checks it two ways: as a validator,
 for code, and as a JSON Schema, for an editor. The parts compose into the schema of a whole config.
 
-| Package                                  | Its part of a config                                              |
-| ---------------------------------------- | ----------------------------------------------------------------- |
-| `@wtf/release-trains`                    | The root `trains`, `train` and `dependencies`                     |
-| `@wtf/semantic-release-trains`           | Its entries of `plugins`, each of `wrap`, `generated`, or neither |
-| `@wtf/semantic-release-trains-changelog` | Its entries of `plugins`                                          |
-| `@wtf/semantic-release-npm`              | Its entries of `plugins`                                          |
-| `@wtf/semantic-release-validate`         | Its entries of `plugins`                                          |
-| `@wtf/semantic-release-replace`          | The root `templates`, and its entries of `plugins`                |
+| Package                          | Its part of a config                                              |
+| -------------------------------- | ----------------------------------------------------------------- |
+| `@wtf/release-trains`            | The root `trains`, `train` and `dependencies`                     |
+| `@wtf/semantic-release-trains`   | Its entries of `plugins`, each of `wrap`, `generated`, or neither |
+| `@wtf/semantic-release-npm`      | Its entries of `plugins`                                          |
+| `@wtf/semantic-release-validate` | Its entries of `plugins`                                          |
+| `@wtf/semantic-release-replace`  | The root `templates`, and its entries of `plugins`                |
 
 A part constrains only what it owns, an entry of `plugins` by the name of the plugin, as
 `["@wtf/semantic-release-npm", { "access": "public" }]`, and takes anything else: the
@@ -28,7 +27,6 @@ by its file (`"$id": "schema.json"`) and refers to nothing outside itself. Compo
   "allOf": [
     { "$ref": "./node_modules/@wtf/release-trains/schema.json" },
     { "$ref": "./node_modules/@wtf/semantic-release-trains/schema.json" },
-    { "$ref": "./node_modules/@wtf/semantic-release-trains-changelog/schema.json" },
     { "$ref": "./node_modules/@wtf/semantic-release-npm/schema.json" },
     { "$ref": "./node_modules/@wtf/semantic-release-validate/schema.json" },
     { "$ref": "./node_modules/@wtf/semantic-release-replace/schema.json" }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@wtf/release-docs",
-  "version": "8.1.0",
-  "description": "The guides of the release trains, and the API reference of their packages, which TypeDoc writes: the release of docs commits the reference and publishes it with the guides.",
+  "version": "8.2.1",
+  "description": "The guides of semantic-release for monorepos of more than one ecosystem, released in trains, and the API reference of its packages, which TypeDoc writes: the release of docs commits the reference and publishes it with the guides.",
   "keywords": [
     "documentation",
     "semantic-release"
@@ -38,18 +38,20 @@
   "devDependencies": {
     "@standard-schema/spec": "^1.1.0",
     "@types/node": "^24.10.0",
-    "@wtf/release-cargo": "3.1.0",
-    "@wtf/release-npm": "1.1.0",
+    "@wtf/release-cargo": "3.1.1",
+    "@wtf/release-go": "1.0.0",
+    "@wtf/release-maven": "1.0.0",
+    "@wtf/release-npm": "1.1.1",
     "@wtf/release-replace": "4.0.0",
     "@wtf/release-system": "1.0.1",
-    "@wtf/release-trains": "7.0.0",
-    "@wtf/release-trains-changelog": "7.0.0",
+    "@wtf/release-trains": "7.1.1",
     "@wtf/release-validate": "4.0.0",
-    "@wtf/semantic-release-cargo": "3.1.0",
-    "@wtf/semantic-release-npm": "1.1.0",
+    "@wtf/semantic-release-cargo": "3.1.1",
+    "@wtf/semantic-release-go": "1.0.0",
+    "@wtf/semantic-release-maven": "1.0.0",
+    "@wtf/semantic-release-npm": "1.1.1",
     "@wtf/semantic-release-replace": "4.0.0",
-    "@wtf/semantic-release-trains": "7.0.0",
-    "@wtf/semantic-release-trains-changelog": "7.0.0",
+    "@wtf/semantic-release-trains": "7.1.1",
     "@wtf/semantic-release-validate": "4.0.0",
     "ajv": "^8.20.0",
     "semantic-release": "^25.0.9",

package/api/@wtf/release-trains-changelog/README.md

@@ -1,58 +0,0 @@
-[**Release trains**](../../README.md)
-
-***
-
-[Release trains](../../README.md) / @wtf/release-trains-changelog
-
-# @wtf/release-trains-changelog
-
-A changelog of each package of a release train, of no release tool: the section of a release
-of the commits that change its own folder, grouped by their type, at the top of its changelog;
-and of the train, of all its commits, where it names one. This module declares what a changelog
-is given; the code is at the subpaths, each by the `system` its caller gives it:
-
-- `./render`: a commit read, the section of a release rendered and put at the top of a
-  changelog, and the section of a version found again;
-- `./write`: the changelogs of a release of a train written, and the faults of where they go.
-
-## References
-
-### ChangelogCommit
-
-Re-exports [ChangelogCommit](render/interfaces/ChangelogCommit.md)
-
-***
-
-### ChangelogOptions
-
-Re-exports [ChangelogOptions](write/interfaces/ChangelogOptions.md)
-
-***
-
-### ChangelogRelease
-
-Re-exports [ChangelogRelease](write/interfaces/ChangelogRelease.md)
-
-***
-
-### ChangelogTarget
-
-Re-exports [ChangelogTarget](write/interfaces/ChangelogTarget.md)
-
-***
-
-### ParsedCommit
-
-Re-exports [ParsedCommit](render/interfaces/ParsedCommit.md)
-
-***
-
-### RenderOptions
-
-Re-exports [RenderOptions](render/interfaces/RenderOptions.md)
-
-***
-
-### WrittenChangelog
-
-Re-exports [WrittenChangelog](write/interfaces/WrittenChangelog.md)

package/api/@wtf/release-trains-changelog/render/README.md

@@ -1,44 +0,0 @@
-[**Release trains**](../../../README.md)
-
-***
-
-[Release trains](../../../README.md) / @wtf/release-trains-changelog/render
-
-# @wtf/release-trains-changelog/render
-
-A changelog as text: a commit read by its Conventional Commits header and its footer
-([parseCommit](functions/parseCommit.md)), the section of a release rendered of its commits, grouped by their type
-([renderSection](functions/renderSection.md)), a section put at the top of a changelog ([prependSection](functions/prependSection.md)), and
-the section of a version found again ([changelogSection](functions/changelogSection.md)).
-
-```ts
-import { renderSection } from '@wtf/release-trains-changelog/render'
-
-const section = renderSection(
-  [{ hash: '0123456789abcdef', message: 'feat(semantic-release-trains): the option cascade' }],
-  { version: '1.2.0', date: '2026-10-30' }
-)
-// ## 1.2.0 (2026-10-30)
-//
-// ### Features
-//
-// - **semantic-release-trains:** the option cascade (0123456)
-```
-
-## Interfaces
-
-- [ChangelogCommit](interfaces/ChangelogCommit.md)
-- [ParsedCommit](interfaces/ParsedCommit.md)
-- [RenderOptions](interfaces/RenderOptions.md)
-
-## Variables
-
-- [DEFAULT\_TYPES](variables/DEFAULT_TYPES.md)
-- [TITLE](variables/TITLE.md)
-
-## Functions
-
-- [changelogSection](functions/changelogSection.md)
-- [parseCommit](functions/parseCommit.md)
-- [prependSection](functions/prependSection.md)
-- [renderSection](functions/renderSection.md)

package/api/@wtf/release-trains-changelog/render/functions/changelogSection.md

@@ -1,35 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / changelogSection
-
-# Function: changelogSection()
-
-> **changelogSection**(`changelog`, `version`): `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:179](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L179)
-
-The section of `version` of a changelog, from its heading to the next one, as this package or
-conventional-changelog writes it: `## 2.1.0 (date)`, `# [2.1.0](…) (date)` or `## [2.1.1](…)`;
-empty, where it has none.
-
-## Parameters
-
-### changelog
-
-`string`
-
-The text of the changelog to look in.
-
-### version
-
-`string`
-
-The version of the section, as `2.1.0`.
-
-## Returns
-
-`string`
-
-The section, trimmed, its heading first, or empty of none.

package/api/@wtf/release-trains-changelog/render/functions/parseCommit.md

@@ -1,28 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / parseCommit
-
-# Function: parseCommit()
-
-> **parseCommit**(`commit`): [`ParsedCommit`](../interfaces/ParsedCommit.md) \| `undefined`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:54](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L54)
-
-The commit of `commit`'s message, read by its Conventional Commits header and its
-`BREAKING CHANGE:` footer; `undefined` of a message of no such header, as of a merge commit.
-
-## Parameters
-
-### commit
-
-[`ChangelogCommit`](../interfaces/ChangelogCommit.md)
-
-The commit to read: its hash and its message.
-
-## Returns
-
-[`ParsedCommit`](../interfaces/ParsedCommit.md) \| `undefined`
-
-The commit read, or `undefined` of a message of no Conventional Commits header.

package/api/@wtf/release-trains-changelog/render/functions/prependSection.md

@@ -1,40 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / prependSection
-
-# Function: prependSection()
-
-> **prependSection**(`existing`, `section`, `title?`): `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:159](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L159)
-
-`section` at the top of the changelog `existing`, under its title: a changelog of `title` and
-the section, of none.
-
-## Parameters
-
-### existing
-
-`string` \| `undefined`
-
-The text of the changelog, or `undefined` of none yet.
-
-### section
-
-`string`
-
-The section of the release, to put first.
-
-### title?
-
-`string` = `TITLE`
-
-The title of the changelog, kept at its top: [TITLE](../variables/TITLE.md) by default.
-
-## Returns
-
-`string`
-
-The changelog, the section first under its title.

package/api/@wtf/release-trains-changelog/render/functions/renderSection.md

@@ -1,37 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / renderSection
-
-# Function: renderSection()
-
-> **renderSection**(`commits`, `options`): `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:110](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L110)
-
-The section of a release, of its commits: `## <version> (<date>)`, its breaking changes first,
-then a heading of each type of [RenderOptions.types](../interfaces/RenderOptions.md#types) that has a commit, each commit a line
-of its scope, its subject and its short hash, in the order given. Empty, of commits that show
-nothing, as of `chore:` alone.
-
-## Parameters
-
-### commits
-
-readonly [`ChangelogCommit`](../interfaces/ChangelogCommit.md)[]
-
-The commits of the release, in the order their lines show.
-
-### options
-
-[`RenderOptions`](../interfaces/RenderOptions.md)
-
-The version and the day of the release, the types shown and the page of a
-commit.
-
-## Returns
-
-`string`
-
-The section, as markdown, or empty of commits that show nothing.

package/api/@wtf/release-trains-changelog/render/interfaces/ChangelogCommit.md

@@ -1,27 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / ChangelogCommit
-
-# Interface: ChangelogCommit
-
-Defined in: [packages/release-trains-changelog/src/render.ts:26](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L26)
-
-A commit as a changelog reads one: its hash and its message.
-
-## Properties
-
-### hash
-
-> `readonly` **hash**: `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:27](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L27)
-
-***
-
-### message
-
-> `readonly` **message**: `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:28](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L28)

package/api/@wtf/release-trains-changelog/render/interfaces/ParsedCommit.md

@@ -1,53 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / ParsedCommit
-
-# Interface: ParsedCommit
-
-Defined in: [packages/release-trains-changelog/src/render.ts:32](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L32)
-
-A commit of a Conventional Commits header, read.
-
-## Properties
-
-### breaking
-
-> `readonly` **breaking**: `string` \| `undefined`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:38](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L38)
-
-What it breaks: its `BREAKING CHANGE:` footer, or its subject of a `type!:` header alone.
-
-***
-
-### hash
-
-> `readonly` **hash**: `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:33](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L33)
-
-***
-
-### scope
-
-> `readonly` **scope**: `string` \| `undefined`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:35](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L35)
-
-***
-
-### subject
-
-> `readonly` **subject**: `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:36](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L36)
-
-***
-
-### type
-
-> `readonly` **type**: `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:34](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L34)

package/api/@wtf/release-trains-changelog/render/interfaces/RenderOptions.md

@@ -1,65 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / RenderOptions
-
-# Interface: RenderOptions
-
-Defined in: [packages/release-trains-changelog/src/render.ts:79](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L79)
-
-How a section is rendered.
-
-## Properties
-
-### commitUrl?
-
-> `readonly` `optional` **commitUrl?**: (`hash`) => `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:92](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L92)
-
-The page of a commit, by its hash, which each line links: none by default.
-
-#### Parameters
-
-##### hash
-
-`string`
-
-The full hash of the commit.
-
-#### Returns
-
-`string`
-
-The URL of the commit's page.
-
-***
-
-### date
-
-> `readonly` **date**: `string` \| `Date`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:83](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L83)
-
-The day of the release: a date, or its `YYYY-MM-DD`.
-
-***
-
-### types?
-
-> `readonly` `optional` **types?**: readonly (readonly \[`string`, `string`\])[]
-
-Defined in: [packages/release-trains-changelog/src/render.ts:85](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L85)
-
-The types shown, each with its heading, in order: [DEFAULT\_TYPES](../variables/DEFAULT_TYPES.md).
-
-***
-
-### version
-
-> `readonly` **version**: `string`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:81](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L81)
-
-The version of the release.

package/api/@wtf/release-trains-changelog/render/variables/DEFAULT_TYPES.md

@@ -1,13 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / DEFAULT\_TYPES
-
-# Variable: DEFAULT\_TYPES
-
-> `const` **DEFAULT\_TYPES**: readonly (readonly \[`string`, `string`\])[]
-
-Defined in: [packages/release-trains-changelog/src/render.ts:71](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L71)
-
-The types a changelog shows, each with its heading, in order: features, fixes, performance, reverts.

package/api/@wtf/release-trains-changelog/render/variables/TITLE.md

@@ -1,13 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/render](../README.md) / TITLE
-
-# Variable: TITLE
-
-> `const` **TITLE**: `"# Changelog"` = `'# Changelog'`
-
-Defined in: [packages/release-trains-changelog/src/render.ts:148](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/render.ts#L148)
-
-The title of a changelog by default.

package/api/@wtf/release-trains-changelog/write/README.md

@@ -1,48 +0,0 @@
-[**Release trains**](../../../README.md)
-
-***
-
-[Release trains](../../../README.md) / @wtf/release-trains-changelog/write
-
-# @wtf/release-trains-changelog/write
-
-The changelogs of a release of a train, written: one of each package of the train, of the
-commits that change its own folder, and one of the train, of its commits, where it names one
-([writeChangelogs](functions/writeChangelogs.md)); the faults of where they go, found before the release
-([changelogErrors](functions/changelogErrors.md)); and the page of a commit of a repository's URL ([commitUrlOf](functions/commitUrlOf.md)).
-
-The packages of a train are those the ecosystems of the repo give, of
-`@wtf/release-trains/ecosystem`: a folder of two ecosystems, as of an npm package and a crate,
-has one changelog.
-
-```ts
-import type { System } from '@wtf/release-system/system'
-import type { Ecosystem } from '@wtf/release-trains/ecosystem'
-import { writeChangelogs } from '@wtf/release-trains-changelog/write'
-
-// The system of the caller, Node's of a plugin, its own of a CLI; and an ecosystem of the repo.
-declare const system: System
-declare const npm: Ecosystem
-
-await writeChangelogs({
-  trains: { trains: { paths: ['packages/release-trains', 'packages/release-trains-*'] } },
-  train: 'trains',
-  ecosystems: [npm],
-  version: '1.2.0',
-  commits: [{ hash: '0123456789abcdef0123456789abcdef01234567', message: 'feat: add a flag' }],
-  system
-})
-```
-
-## Interfaces
-
-- [ChangelogOptions](interfaces/ChangelogOptions.md)
-- [ChangelogRelease](interfaces/ChangelogRelease.md)
-- [ChangelogTarget](interfaces/ChangelogTarget.md)
-- [WrittenChangelog](interfaces/WrittenChangelog.md)
-
-## Functions
-
-- [changelogErrors](functions/changelogErrors.md)
-- [commitUrlOf](functions/commitUrlOf.md)
-- [writeChangelogs](functions/writeChangelogs.md)

package/api/@wtf/release-trains-changelog/write/functions/changelogErrors.md

@@ -1,33 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/write](../README.md) / changelogErrors
-
-# Function: changelogErrors()
-
-> **changelogErrors**(`target`): `Promise`\<[`TrainsError`](../../../release-trains/errors/classes/TrainsError.md)[]\>
-
-Defined in: [packages/release-trains-changelog/src/write.ts:240](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/write.ts#L240)
-
-The faults of where the changelogs of the train go, before a release writes them: the train
-chosen and declared (`ETRAINNOTSELECTED`, `ETRAINUNKNOWN`), and a changelog of the train,
-`trainChangelog`, that is the changelog of one of its packages, or of another train or one of its
-packages (`ECHANGELOG`): the sections of two of the same version would stand in one changelog,
-the second over the first. A `file` of `false` with no `trainChangelog` writes no changelog at
-all (`ECHANGELOG`).
-
-## Parameters
-
-### target
-
-[`ChangelogTarget`](../interfaces/ChangelogTarget.md)
-
-The trains, the train of the release, the ecosystems of the repo, and the options
-of its changelogs.
-
-## Returns
-
-`Promise`\<[`TrainsError`](../../../release-trains/errors/classes/TrainsError.md)[]\>
-
-The faults found, empty of none.

package/api/@wtf/release-trains-changelog/write/functions/commitUrlOf.md

@@ -1,29 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/write](../README.md) / commitUrlOf
-
-# Function: commitUrlOf()
-
-> **commitUrlOf**(`url`): ((`hash`) => `string`) \| `undefined`
-
-Defined in: [packages/release-trains-changelog/src/write.ts:132](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/write.ts#L132)
-
-The page of a commit of the repository at `url`, or `undefined` of a URL of no web page, as of a
-path: `<url>/-/commit/<hash>` of GitLab, `<url>/commit/<hash>` of others. An SSH URL is read as
-its host's HTTPS one.
-
-## Parameters
-
-### url
-
-`string` \| `undefined`
-
-The URL of the repository, HTTPS or SSH, as a package's `repository.url`.
-
-## Returns
-
-((`hash`) => `string`) \| `undefined`
-
-The page of a commit, by its hash, or `undefined` of none.

package/api/@wtf/release-trains-changelog/write/functions/writeChangelogs.md

@@ -1,35 +0,0 @@
-[**Release trains**](../../../../README.md)
-
-***
-
-[Release trains](../../../../README.md) / [@wtf/release-trains-changelog/write](../README.md) / writeChangelogs
-
-# Function: writeChangelogs()
-
-> **writeChangelogs**(`release`): `Promise`\<[`WrittenChangelog`](../interfaces/WrittenChangelog.md)[]\>
-
-Defined in: [packages/release-trains-changelog/src/write.ts:159](https://gitlab.com/wetryfun/release/release/-/blob/e8884f72193f59f831b5f9a2797121152ce6f3cb/packages/release-trains-changelog/src/write.ts#L159)
-
-Writes the changelogs of a release of the train: for each package of the train, unless `file` is
-`false`, the section of the commits of `commits` that change its folder, at the top of its
-changelog, if any shows; and,
-of `trainChangelog`, the section of every commit of the train. A changelog that holds the entries
-of the run's section already, under a heading of the version, as of a release run again after a
-publish that failed, is kept as it is, so none is written twice; a section of other entries, of
-the same version, as of a run of more commits, is left, and the run's is written over it, so no
-entry is lost. Gives each it wrote, and each it kept.
-
-## Parameters
-
-### release
-
-[`ChangelogRelease`](../interfaces/ChangelogRelease.md)
-
-The release: its trains, its train and the ecosystems of the repo, its version,
-its commits, and the options of its changelogs.
-
-## Returns
-
-`Promise`\<[`WrittenChangelog`](../interfaces/WrittenChangelog.md)[]\>
-
-The changelogs written and kept, each with the count of its commits.