docs: decide which host the CHANGELOG release links target #393

Closed

opened 2026-09-25 00:48:17 +09:00 by natsukium · 2 comments

natsukium commented

2026-09-25 00:48:17 +09:00

Owner

The link references in CHANGELOG.md ([0.1.0], [Unreleased]) point at github.com/felis-terminal/felis/{compare,releases/tag}. Release assets, however, are published by the Forgejo release.yml, and docs/how-to/install.md says to "Open the release page … on Forgejo". README calls GitHub a mirror, and the mirror receives tags, so the GitHub releases/tag page may show a bare tag with no assets.

Decide which host the changelog links target (git.natsukium.com releases/compare, or GitHub as the public face). If GitHub stays, decide whether the mirror should also carry releases. The release gate (tools/release/verify.py) should check whichever form is chosen.

The link references in `CHANGELOG.md` (`[0.1.0]`, `[Unreleased]`) point at `github.com/felis-terminal/felis/{compare,releases/tag}`. Release assets, however, are published by the Forgejo `release.yml`, and `docs/how-to/install.md` says to "Open the release page … on Forgejo". README calls GitHub a mirror, and the mirror receives tags, so the GitHub `releases/tag` page may show a bare tag with no assets. Decide which host the changelog links target (git.natsukium.com releases/compare, or GitHub as the public face). If GitHub stays, decide whether the mirror should also carry releases. The release gate (`tools/release/verify.py`) should check whichever form is chosen.

natsukium added the

type/design

label

2026-09-25 00:48:17 +09:00

natsukium referenced this issue

2026-09-25 00:48:41 +09:00

docs: fix inconsistencies found by a tree-wide docs and skills audit #395

natsukium referenced this issue from a commit

2026-09-25 00:54:55 +09:00

docs: fix inconsistencies found by a tree-wide docs and skills audit (#395)

natsukium commented

2026-09-25 11:45:19 +09:00

Author

Owner

Decision: the CHANGELOG link references target the public Forgejo repository at https://git.natsukium.com/felis-terminal/felis (releases/tag/v… and compare/…), where the release assets are published. tools/release/verify.py checks that form.

Decision: the CHANGELOG link references target the public Forgejo repository at `https://git.natsukium.com/felis-terminal/felis` (`releases/tag/v…` and `compare/…`), where the release assets are published. `tools/release/verify.py` checks that form.

natsukium referenced this issue from a commit

2026-09-25 13:00:19 +09:00

release: link the CHANGELOG to the Forgejo repository and gate it

natsukium referenced this issue from a pull request that will close it,

2026-09-25 13:00:40 +09:00

release: link the CHANGELOG to the Forgejo repository and gate it #448

natsukium commented

2026-09-25 13:10:49 +09:00

Author

Owner

Closing: the CHANGELOG keeps pointing at the GitHub mirror, which main already does. PR #448 was closed unmerged.

natsukium closed this issue