@wtf/release-docs 9.0.2 → 10.0.0

package/api/@wtf/semantic-release-cargo/{functions → variables}/publish.md

@@ -4,14 +4,15 @@
 
 [Release trains](../../../README.md) / [@wtf/semantic-release-cargo](../README.md) / publish
 
-# Function: publish()
+# Variable: publish
 
-> **publish**(`pluginConfig`, `context`): `Promise`\<`false` \| [`CargoRelease`](../interfaces/CargoRelease.md)\>
+> `const` **publish**: (`pluginConfig`, `context`) => `Promise`\<`false` \| [`CargoRelease`](../interfaces/CargoRelease.md)\>
 
-Defined in: [packages/semantic-release-cargo/src/index.ts:466](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-cargo/src/index.ts#L466)
+Defined in: [packages/semantic-release-cargo/src/index.ts:350](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L350)
 
-Publishes each crate of the release the registry lacks, in the order of their dependencies, at the
-version of the release; each the registry has already is skipped.
+Runs the ecosystem's `publish`: publishes each crate of the release the registry lacks, in the
+order of the plan, at the version of the release; each the registry has already is skipped. It
+records each crate for the links of the release of the host.
 
 ## Parameters
 

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

@@ -0,0 +1,37 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / [@wtf/semantic-release-cargo](../README.md) / verifyConditions
+
+# Variable: verifyConditions
+
+> `const` **verifyConditions**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
+
+Defined in: [packages/semantic-release-cargo/src/index.ts:263](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L263)
+
+Checks the options of the plugin, by `cargoSchema` of `./schema` (`EOPTIONS`), that `ecosystems`
+lists `@wtf/semantic-release-cargo/ecosystem` or `@wtf/release-cargo` (`ECARGOECOSYSTEM`), and the
+train of the run (`ETRAINNOTSELECTED`, `ETRAINUNKNOWN`); and works out the plan of the train, of
+no version yet, by the trains' own checks: no crate is of two trains (`ETRAINOVERLAP`), and each
+crate of another train the crates of the train depend on has a release (`EDEPENDENCYNOTRAIN`,
+`EDEPENDENCYNORELEASE`). It checks no version: `verifyRelease` does, once it is known.
+
+## Parameters
+
+### pluginConfig
+
+[`CargoPluginOptions`](../interfaces/CargoPluginOptions.md)
+
+The plugin's options of the config, with `trains` of its root.
+
+### context
+
+`VerifyConditionsContext` & `OfRun`
+
+The context of semantic-release's `verifyConditions` step: the folder, the
+environment and the logger of the run.
+
+## Returns
+
+`Promise`\<`void`\>

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

@@ -0,0 +1,37 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / [@wtf/semantic-release-cargo](../README.md) / verifyRelease
+
+# Variable: verifyRelease
+
+> `const` **verifyRelease**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
+
+Defined in: [packages/semantic-release-cargo/src/index.ts:291](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-cargo/src/index.ts#L291)
+
+Runs the ecosystem's `verify`, once semantic-release knows the version of the release: that the
+version is one of semver (`ECRATESEMVER`); that a `registry` has its `index` (`EOPTIONS`); that
+the workspace reads, its crates select and order (`ECARGO`, `ECRATES`, `ECRATEPRIVATE`,
+`ECRATEORDER`); and that the environment holds a credential, an ID token or a token
+(`ECRATEAUTH`), which a dry run needs none of, and warns so. It asks the registry nothing. What it
+says and throws names the train.
+
+## Parameters
+
+### pluginConfig
+
+[`CargoPluginOptions`](../interfaces/CargoPluginOptions.md)
+
+The plugin's options of the config, with `trains` of its root.
+
+### context
+
+`VerifyReleaseContext` & `OfRun`
+
+The context of semantic-release's `verifyRelease` step: the folder, the
+environment and the logger of the run, and the next release.
+
+## Returns
+
+`Promise`\<`void`\>

package/api/@wtf/semantic-release-go/README.md

@@ -6,36 +6,43 @@
 
 # @wtf/semantic-release-go
 
-The plugin of semantic-release that releases the Go modules of a train of a repo, by
-`@wtf/release-go`, in the steps of semantic-release, and writes no version into git on the
-branch: each go.mod requires the modules of the repo at a placeholder, as `v0.0.0`, and the tags
-are the versions. Go has no registry: a release of a module is its tag, `<folder>/v<version>`, or
-`v<version>` at the root, on a commit whose go.mod files require the modules of the repo at their
-releases. Put it in the plugins of the run of a tag. It reads `trains` and `ecosystems` of its
-options, which semantic-release gives it of the root of the config, and the train of the run of
-its option `train`, or else `RELEASE_TRAIN` of the environment of the run, as
-`@wtf/semantic-release-npm` does; and the modules as the trains read them, of the ecosystem of Go
-(`goEcosystem` of `@wtf/release-go/ecosystem`): the modules of the release are the modules of the
-train, whose `paths` hold their folder (`ownersOf` of `@wtf/release-trains/packages`).
+The plugin of semantic-release that releases the Go modules of a train of a repo, by the ecosystem
+of Go of `@wtf/release-go`, a `ReleasingEcosystem` of `@wtf/release/contract`, in the steps of
+semantic-release, and writes no version into git on the branch: each go.mod requires the modules
+of the repo at a placeholder, as `v0.0.0`, and the tags are the versions. Go has no registry: a
+release of a module is its tag, `<folder>/v<version>`, or `v<version>` at the root, on a commit
+whose go.mod files require the modules of the repo at their releases. Put it in the plugins of the
+run of a tag. It reads `trains` and `ecosystems` of its options, which semantic-release gives it
+of the root of the config, and the train of the run of its option `train`, or else
+`RELEASE_TRAIN` of the environment of the run, as `@wtf/semantic-release-npm` does. Each step maps
+the run onto the contract: a `Release` of the next release, the dry run and the logger of the run,
+and the platform and the folder of `runOf` of `@wtf/semantic-release`, each line and error of it
+named by the train (`stepRelease` and `inTrain` of `@wtf/semantic-release/release`); and the plan
+of the train
+(`planOf` of `@wtf/release-trains/plan`), the modules of the train that Go can fetch, and the
+version of each module of the repo, the release's of the train's, the last release of each other
+train's.
 
-- `verifyConditions` checks the options, reads the go.mod files git tracks, selects the modules
-  the release tags, and reads the last release of each other train, by its tags
-  (`releasedVersions` of `@wtf/release-trains/packages`), so a repo that cannot be released fails
-  before the tag: of a module that requires a module of no train (`EDEPENDENCYNOTRAIN`), or of a
-  train with no release (`EDEPENDENCYNORELEASE`);
-- `verifyRelease` checks the path of each module of the release against the major of its
-  version (`EGOMAJOR`): from v2 on, a module path ends in `/v<major>`;
-- `prepare` checks the majors again, writes the version of the release into each require of a
-  module of the train, and the last release of each other train into each require of its modules,
-  in every go.mod of the repo (`stampModules`), and reads them again, so a require that is not at
-  the version of its train fails the run (`EGOVERSION`);
-- `publish` makes a commit of the stamped go.mod files on top of `HEAD`, on no branch, tags it
-  with the tag of each module the remote lacks, and pushes them in one atomic push, to
-  `repositoryUrl` of the run (`tagModules`), skipping each the remote has, so a release that
-  stopped part way is finished by running it again; then, of the option `proxy`, asks the Go proxy
-  for each module at its version (`askProxy`); and records each module for the links of the
-  release of the host (`recordReleased` of `@wtf/release-trains/links`): its page on pkg.go.dev,
-  of `proxy`, and else its folder at its tag.
+- `verifyConditions` checks the options, works out the plan of the train, of no version yet,
+  which reads the last release of each other train, by its tags, so a repo that cannot be
+  released fails before the tag: of a module that requires a module of no train (`EDEPENDENCYNOTRAIN`), or of a train with
+  no release (`EDEPENDENCYNORELEASE`); and selects the modules the release tags
+  (`releaseModules` of `@wtf/release-go/release`);
+- `verifyRelease` runs the ecosystem's `verify`, which checks the path of each module of the
+  release against the major of its version (`EGOMAJOR`): from v2 on, a module path ends in
+  `/v<major>`;
+- `prepare` runs `prepare`, which writes the version of the release into each
+  require of a module of the train, and the last release of each other train into each require of
+  its modules, in every go.mod of the repo, and reads them again, so a require that is not at the
+  version of its train fails the run (`EGOVERSION`);
+- `publish` runs `publish`, which makes a commit of the stamped go.mod files on top of `HEAD`, on
+  no branch, of the author of `GIT_AUTHOR_*` and the committer of `GIT_COMMITTER_*` of the
+  environment, else `semantic-release-bot`, tags it with the tag of each module the remote lacks,
+  and pushes them in one atomic push, to `repositoryUrl` of the run, skipping each the remote has,
+  so a release that stopped part way is finished by running it again; then, of the option
+  `proxy`, asks the Go proxy for each module at its version; and records each module for the
+  links of the release of the host (`recordReleased` of `@wtf/semantic-release/links`): its page
+  on pkg.go.dev, of `proxy`, and else its folder at its tag.
 
 A dry run of semantic-release runs `verifyConditions` and `verifyRelease` alone of these: it
 skips `prepare` and `publish`, so it stamps and tags nothing.
@@ -66,10 +73,7 @@ export default {
 ## Variables
 
 - [default](variables/default.md)
-
-## Functions
-
-- [prepare](functions/prepare.md)
-- [publish](functions/publish.md)
-- [verifyConditions](functions/verifyConditions.md)
-- [verifyRelease](functions/verifyRelease.md)
+- [prepare](variables/prepare.md)
+- [publish](variables/publish.md)
+- [verifyConditions](variables/verifyConditions.md)
+- [verifyRelease](variables/verifyRelease.md)

package/api/@wtf/semantic-release-go/interfaces/GoPluginOptions.md

@@ -6,7 +6,7 @@
 
 # Interface: GoPluginOptions
 
-Defined in: [packages/semantic-release-go/src/index.ts:81](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L81)
+Defined in: [packages/semantic-release-go/src/index.ts:90](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L90)
 
 The options of the plugin, in the config of semantic-release or at its root.
 
@@ -16,7 +16,7 @@ The options of the plugin, in the config of semantic-release or at its root.
 
 > `readonly` **ecosystems**: readonly `string`[]
 
-Defined in: [packages/semantic-release-go/src/index.ts:89](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L89)
+Defined in: [packages/semantic-release-go/src/index.ts:98](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L98)
 
 The ecosystems of the repo, of the root of the config, which the trains read the packages of:
 `'@wtf/semantic-release-go/ecosystem'` or `'@wtf/release-go'` among them, or
@@ -28,7 +28,7 @@ The ecosystems of the repo, of the root of the config, which the trains read the
 
 > `readonly` `optional` **exclude?**: readonly `string`[]
 
-Defined in: [packages/semantic-release-go/src/index.ts:97](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L97)
+Defined in: [packages/semantic-release-go/src/index.ts:106](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L106)
 
 The modules of the train not to tag, by path, as an example.
 
@@ -38,7 +38,7 @@ The modules of the train not to tag, by path, as an example.
 
 > `readonly` `optional` **include?**: readonly `string`[]
 
-Defined in: [packages/semantic-release-go/src/index.ts:95](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L95)
+Defined in: [packages/semantic-release-go/src/index.ts:104](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L104)
 
 The modules of the train to tag, by path: every module of it that Go can fetch by default.
 
@@ -48,28 +48,18 @@ The modules of the train to tag, by path: every module of it that Go can fetch b
 
 > `readonly` `optional` **proxy?**: `boolean`
 
-Defined in: [packages/semantic-release-go/src/index.ts:102](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L102)
+Defined in: [packages/semantic-release-go/src/index.ts:111](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L111)
 
 Whether `publish` asks the Go proxy for each module at its version once its tag is pushed:
 `false`, as the public proxy cannot fetch a private repo.
 
 ***
 
-### system?
-
-> `readonly` `optional` **system?**: [`SystemInput`](../../release-system/system/type-aliases/SystemInput.md)
-
-Defined in: [packages/semantic-release-go/src/index.ts:104](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L104)
-
-The system the plugin runs by, over Node's.
-
-***
-
 ### train?
 
 > `readonly` `optional` **train?**: `string`
 
-Defined in: [packages/semantic-release-go/src/index.ts:91](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L91)
+Defined in: [packages/semantic-release-go/src/index.ts:100](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L100)
 
 The train of the run: `RELEASE_TRAIN` of the environment of the run by default.
 
@@ -79,6 +69,6 @@ The train of the run: `RELEASE_TRAIN` of the environment of the run by default.
 
 > `readonly` **trains**: [`Trains`](../../release-trains/type-aliases/Trains.md)
 
-Defined in: [packages/semantic-release-go/src/index.ts:83](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L83)
+Defined in: [packages/semantic-release-go/src/index.ts:92](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L92)
 
 Every train of the repo: the modules of each are those whose folder its paths hold.

package/api/@wtf/semantic-release-go/interfaces/GoRelease.md

@@ -6,7 +6,7 @@
 
 # Interface: GoRelease
 
-Defined in: [packages/semantic-release-go/src/index.ts:108](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L108)
+Defined in: [packages/semantic-release-go/src/index.ts:115](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L115)
 
 The release the plugin gives semantic-release of the modules tagged.
 
@@ -16,7 +16,7 @@ The release the plugin gives semantic-release of the modules tagged.
 
 > `readonly` **name**: `string`
 
-Defined in: [packages/semantic-release-go/src/index.ts:110](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L110)
+Defined in: [packages/semantic-release-go/src/index.ts:117](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L117)
 
 The modules named, as `Go modules (example.com/a, example.com/b)`.
 
@@ -26,6 +26,6 @@ The modules named, as `Go modules (example.com/a, example.com/b)`.
 
 > `readonly` `optional` **url?**: `string`
 
-Defined in: [packages/semantic-release-go/src/index.ts:112](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L112)
+Defined in: [packages/semantic-release-go/src/index.ts:119](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L119)
 
 The page of the first module on pkg.go.dev, of a release that asked the proxy.

package/api/@wtf/semantic-release-go/schema/README.md

@@ -6,11 +6,11 @@
 
 # @wtf/semantic-release-go/schema
 
-The schema of the options of the plugin, as validators of `@wtf/release-system/validator`: each a
+The schema of the options of the plugin, as validators of `@wtf/release/validator`: each a
 Standard Schema, and a Standard JSON Schema of the JSON Schema of what it checks.
 
 - [goSchema](variables/goSchema.md): the options the plugin is given, of the root of the config, `trains`,
-  `ecosystems`, `train` and `system`, and of its entry, as it checks them;
+  `ecosystems` and `train`, and of its entry, as it checks them;
 - [goOptionsSchema](variables/goOptionsSchema.md): the options of its entry, `include`, `exclude` and `proxy`, its own;
 - [configSchema](variables/configSchema.md): this package's part of a whole config of semantic-release, each entry of
   `plugins` of the plugin, and anything else; its JSON Schema is [jsonSchema](variables/jsonSchema.md), which the

package/api/@wtf/semantic-release-go/schema/type-aliases/GoOptions.md

@@ -6,8 +6,8 @@
 
 # Type Alias: GoOptions
 
-> **GoOptions** = `Omit`\<[`GoPluginOptions`](../../interfaces/GoPluginOptions.md), `"train"` \| `"trains"` \| `"ecosystems"` \| `"system"`\>
+> **GoOptions** = `Omit`\<[`GoPluginOptions`](../../interfaces/GoPluginOptions.md), `"train"` \| `"trains"` \| `"ecosystems"`\>
 
-Defined in: [packages/semantic-release-go/src/schema.ts:39](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/schema.ts#L39)
+Defined in: [packages/semantic-release-go/src/schema.ts:39](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/schema.ts#L39)
 
 The options of an entry of the plugin, its own: every one of the options but those of the root.

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

@@ -6,8 +6,8 @@
 
 # Variable: configSchema
 
-> `const` **configSchema**: [`Validator`](../../../release-system/validator/interfaces/Validator.md)\<`object`\>
+> `const` **configSchema**: [`Validator`](../../../release/validator/interfaces/Validator.md)\<`object`\>
 
-Defined in: [packages/semantic-release-go/src/schema.ts:58](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/schema.ts#L58)
+Defined in: [packages/semantic-release-go/src/schema.ts:58](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/schema.ts#L58)
 
 This package's part of a whole config of semantic-release: each entry of `plugins` of the plugin.

package/api/@wtf/semantic-release-go/schema/variables/goOptionsSchema.md

@@ -6,8 +6,8 @@
 
 # Variable: goOptionsSchema
 
-> `const` **goOptionsSchema**: [`Validator`](../../../release-system/validator/interfaces/Validator.md)\<[`GoOptions`](../type-aliases/GoOptions.md)\>
+> `const` **goOptionsSchema**: [`Validator`](../../../release/validator/interfaces/Validator.md)\<[`GoOptions`](../type-aliases/GoOptions.md)\>
 
-Defined in: [packages/semantic-release-go/src/schema.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/schema.ts#L42)
+Defined in: [packages/semantic-release-go/src/schema.ts:42](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/schema.ts#L42)
 
 The validator of the options of an entry of the plugin, its own.

package/api/@wtf/semantic-release-go/schema/variables/goSchema.md

@@ -6,9 +6,9 @@
 
 # Variable: goSchema
 
-> `const` **goSchema**: [`Validator`](../../../release-system/validator/interfaces/Validator.md)\<[`RootOptions`](../../../release-trains/schema/interfaces/RootOptions.md) & [`GoOptions`](../type-aliases/GoOptions.md)\>
+> `const` **goSchema**: [`Validator`](../../../release/validator/interfaces/Validator.md)\<[`RootOptions`](../../../release-trains/schema/interfaces/RootOptions.md) & [`GoOptions`](../type-aliases/GoOptions.md)\>
 
-Defined in: [packages/semantic-release-go/src/schema.ts:52](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/schema.ts#L52)
+Defined in: [packages/semantic-release-go/src/schema.ts:52](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/schema.ts#L52)
 
 The validator of the options the plugin is given: the root's, `trains` and `ecosystems` required,
 and its own.

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

@@ -6,8 +6,8 @@
 
 # Variable: jsonSchema
 
-> `const` **jsonSchema**: [`JsonSchema`](../../../release-system/validator/type-aliases/JsonSchema.md)
+> `const` **jsonSchema**: [`JsonSchema`](../../../release/validator/type-aliases/JsonSchema.md)
 
-Defined in: [packages/semantic-release-go/src/schema.ts:64](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/schema.ts#L64)
+Defined in: [packages/semantic-release-go/src/schema.ts:64](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/schema.ts#L64)
 
 The JSON Schema of [configSchema](configSchema.md), as the package publishes it, `schema.json`.

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

@@ -8,7 +8,7 @@
 
 > **default**: `object`
 
-Defined in: [packages/semantic-release-go/src/index.ts:397](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L397)
+Defined in: [packages/semantic-release-go/src/index.ts:402](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L402)
 
 ## Type Declaration
 
@@ -16,10 +16,10 @@ Defined in: [packages/semantic-release-go/src/index.ts:397](https://gitlab.com/w
 
 > **prepare**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
 
-Checks the majors again, writes the version of the release into each require of a module of the
-train, and the last release of each other train into each require of its modules, in every go.mod
-of the repo; and reads them again: a require that is not at the version of its train fails the
-run here, before the tags.
+Runs the ecosystem's `prepare`, of the release `verifyRelease` verified: writes the version of the release into
+each require of a module of the train, and the last release of each other train into each require
+of its modules, in every go.mod of the repo; and reads them again: a require that is not at the
+version of its train fails the run here, before the tags.
 
 #### Parameters
 
@@ -42,18 +42,18 @@ and the logger of the run, and the next release.
 
 #### Throws
 
-`EGOMAJOR` of a path that does not agree with the major, `EDEPENDENCYNOTRAIN` and
-`EDEPENDENCYNORELEASE` of a require of a module of no release, `EGOVERSION` of a require at
-another version after the stamp.
+`EDEPENDENCYNOTRAIN` and `EDEPENDENCYNORELEASE` of a require of a module of no release,
+`EGOVERSION` of a require at another version after the stamp.
 
 ### publish
 
 > **publish**: (`pluginConfig`, `context`) => `Promise`\<`false` \| [`GoRelease`](../interfaces/GoRelease.md)\>
 
-Tags the modules of the release: a commit of the stamped go.mod files on top of `HEAD`, on no
-branch, tagged with the tag of each module the remote lacks, and the tags pushed to
-`repositoryUrl` of the run in one atomic push; each the remote has is skipped. Then, of the option
-`proxy`, asks the Go proxy for each module at its version.
+Runs the ecosystem's `publish`, which tags the modules of the release: a commit of the stamped
+go.mod files on top of `HEAD`, on no branch, tagged with the tag of each module the remote lacks,
+and the tags pushed to `repositoryUrl` of the run in one atomic push; each the remote has is
+skipped. Then, of the option `proxy`, it asks the Go proxy for each module at its version. Each
+module is recorded for the links of the release of the host.
 
 #### Parameters
 
@@ -79,8 +79,9 @@ page on pkg.go.dev; `false` of a train of no module to tag.
 
 #### Throws
 
-`EGOVERSION` of a require not at its version, `EGOTAG` of a remote that cannot be asked or
-a tag that cannot be made or pushed, `EGOPROXY` of a module the proxy cannot give.
+`EGOVERSION` of a require not at its version, `EGOTAG` of a run of no `repositoryUrl`, a
+remote that cannot be asked or a tag that cannot be made or pushed, `EGOPROXY` of a module the
+proxy cannot give.
 
 ### verifyConditions
 
@@ -88,10 +89,11 @@ a tag that cannot be made or pushed, `EGOPROXY` of a module the proxy cannot giv
 
 Checks the options of the plugin, by `goSchema` of `./schema` (`EOPTIONS`), that `ecosystems`
 lists `@wtf/semantic-release-go/ecosystem` or `@wtf/release-go` (`EGOECOSYSTEM`), and the train of
-the run (`ETRAINNOTSELECTED`, `ETRAINUNKNOWN`); that the go.mod files read and the modules select:
-`EGOMOD`, `EGOMODULES`, `EGOPRIVATE`; that no module is of two trains (`ETRAINOVERLAP`), and each
-module of another train the modules of the train require has a release, by the trains' own checks
-(`EDEPENDENCYNOTRAIN`, `EDEPENDENCYNORELEASE`). It asks the remote nothing.
+the run (`ETRAINNOTSELECTED`, `ETRAINUNKNOWN`); that the go.mod files read (`EGOMOD`); that no
+module is of two trains (`ETRAINOVERLAP`), and each module of another train the modules of the
+train require has a release, by the trains' own checks of the plan (`EDEPENDENCYNOTRAIN`,
+`EDEPENDENCYNORELEASE`); and that the modules select: `EGOMODULES`, `EGOPRIVATE`. It asks the
+remote nothing.
 
 #### Parameters
 
@@ -116,9 +118,10 @@ environment and the logger of the run.
 
 > **verifyRelease**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
 
-Checks the path of each module of the release against the major of its version, which semantic-
-release knows by this step: from v2 on, Go needs the path to end in `/v<major>`, and a path that
-ends in `/vN` needs a release of the major N.
+Runs the ecosystem's `verify`, which semantic-release can by this step, as it knows the version:
+the version is one Go tags a module of, and the path of each module of the release agrees with
+its major; from v2 on, Go needs the path to end in `/v<major>`, and a path that ends in `/vN`
+needs a release of the major N.
 
 #### Parameters
 
@@ -141,4 +144,5 @@ environment and the logger of the run, and the next release.
 
 #### Throws
 
-`EGOMAJOR` of each module whose path does not agree with the major, together.
+`EGOSEMVER` of a version Go tags none of, `EGOMAJOR` of each module whose path does not
+agree with the major, together.

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

@@ -0,0 +1,40 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / [@wtf/semantic-release-go](../README.md) / prepare
+
+# Variable: prepare
+
+> `const` **prepare**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
+
+Defined in: [packages/semantic-release-go/src/index.ts:326](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L326)
+
+Runs the ecosystem's `prepare`, of the release `verifyRelease` verified: writes the version of the release into
+each require of a module of the train, and the last release of each other train into each require
+of its modules, in every go.mod of the repo; and reads them again: a require that is not at the
+version of its train fails the run here, before the tags.
+
+## Parameters
+
+### pluginConfig
+
+[`GoPluginOptions`](../interfaces/GoPluginOptions.md)
+
+The plugin's options of the config, with `trains` of its root.
+
+### context
+
+`VerifyReleaseContext` & `OfRun`
+
+The context of semantic-release's `prepare` step: the folder, the environment
+and the logger of the run, and the next release.
+
+## Returns
+
+`Promise`\<`void`\>
+
+## Throws
+
+`EDEPENDENCYNOTRAIN` and `EDEPENDENCYNORELEASE` of a require of a module of no release,
+`EGOVERSION` of a require at another version after the stamp.

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

@@ -0,0 +1,45 @@
+[**Release trains**](../../../README.md)
+
+***
+
+[Release trains](../../../README.md) / [@wtf/semantic-release-go](../README.md) / publish
+
+# Variable: publish
+
+> `const` **publish**: (`pluginConfig`, `context`) => `Promise`\<`false` \| [`GoRelease`](../interfaces/GoRelease.md)\>
+
+Defined in: [packages/semantic-release-go/src/index.ts:360](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L360)
+
+Runs the ecosystem's `publish`, which tags the modules of the release: a commit of the stamped
+go.mod files on top of `HEAD`, on no branch, tagged with the tag of each module the remote lacks,
+and the tags pushed to `repositoryUrl` of the run in one atomic push; each the remote has is
+skipped. Then, of the option `proxy`, it asks the Go proxy for each module at its version. Each
+module is recorded for the links of the release of the host.
+
+## Parameters
+
+### pluginConfig
+
+[`GoPluginOptions`](../interfaces/GoPluginOptions.md)
+
+The plugin's options of the config, with `trains` of its root.
+
+### context
+
+`VerifyReleaseContext` & `OfRun`
+
+The context of semantic-release's `publish` step: the folder, the environment,
+the options and the logger of the run, and the next release.
+
+## Returns
+
+`Promise`\<`false` \| [`GoRelease`](../interfaces/GoRelease.md)\>
+
+The release of the modules, named of each module, and of `proxy` linked to the first's
+page on pkg.go.dev; `false` of a train of no module to tag.
+
+## Throws
+
+`EGOVERSION` of a require not at its version, `EGOTAG` of a run of no `repositoryUrl`, a
+remote that cannot be asked or a tag that cannot be made or pushed, `EGOPROXY` of a module the
+proxy cannot give.

package/api/@wtf/semantic-release-go/{functions → variables}/verifyConditions.md

@@ -4,18 +4,19 @@
 
 [Release trains](../../../README.md) / [@wtf/semantic-release-go](../README.md) / verifyConditions
 
-# Function: verifyConditions()
+# Variable: verifyConditions
 
-> **verifyConditions**(`pluginConfig`, `context`): `Promise`\<`void`\>
+> `const` **verifyConditions**: (`pluginConfig`, `context`) => `Promise`\<`void`\>
 
-Defined in: [packages/semantic-release-go/src/index.ts:240](https://gitlab.com/wetryfun/release/release/-/blob/3b0e2c3c91b521977d05b801e2297d0df9e52834/packages/semantic-release-go/src/index.ts#L240)
+Defined in: [packages/semantic-release-go/src/index.ts:277](https://gitlab.com/wetryfun/release/release/-/blob/27c0c9bead8eea4a721e18a0cbd2724080f82e69/packages/semantic-release-go/src/index.ts#L277)
 
 Checks the options of the plugin, by `goSchema` of `./schema` (`EOPTIONS`), that `ecosystems`
 lists `@wtf/semantic-release-go/ecosystem` or `@wtf/release-go` (`EGOECOSYSTEM`), and the train of
-the run (`ETRAINNOTSELECTED`, `ETRAINUNKNOWN`); that the go.mod files read and the modules select:
-`EGOMOD`, `EGOMODULES`, `EGOPRIVATE`; that no module is of two trains (`ETRAINOVERLAP`), and each
-module of another train the modules of the train require has a release, by the trains' own checks
-(`EDEPENDENCYNOTRAIN`, `EDEPENDENCYNORELEASE`). It asks the remote nothing.
+the run (`ETRAINNOTSELECTED`, `ETRAINUNKNOWN`); that the go.mod files read (`EGOMOD`); that no
+module is of two trains (`ETRAINOVERLAP`), and each module of another train the modules of the
+train require has a release, by the trains' own checks of the plan (`EDEPENDENCYNOTRAIN`,
+`EDEPENDENCYNORELEASE`); and that the modules select: `EGOMODULES`, `EGOPRIVATE`. It asks the
+remote nothing.
 
 ## Parameters