docs: document repository URL override env var

This commit is contained in:
Micheal Wilkinson
2026-03-20 23:40:45 +00:00
parent edb8508e48
commit 2d3c27460f
2 changed files with 2 additions and 1 deletions

View File

@@ -167,7 +167,7 @@ Defaults:
When no `--version-file` flag is provided, `vociferate` derives the current version from the most recent released section heading in the changelog (`## [x.y.z] - ...`). If no prior releases exist, it defaults to `0.0.0` and recommends `v1.0.0` as the first tag.
During prepare, vociferate can normalize changelog heading links when it can determine the repository URL (from CI environment variables or `origin` git remote). If you prefer changelog headings to stay plain while tags are being rebuilt, leave the changelog as plain headings and avoid retaining historical release-tag links.
During prepare, vociferate can normalize changelog heading links when it can determine the repository URL (from CI environment variables or `origin` git remote). If your runner injects an internal host (for example `http://teapot:3000`) into `GITHUB_SERVER_URL`, set `VOCIFERATE_REPOSITORY_URL` at the server/runner level to force the canonical external URL used for changelog links.
When running `--version`, the `release-version` file is created automatically if it does not exist, so new repositories do not need to pre-seed it.