fix(releases): allow native formatting in generated changelog #24

2026-10-10T18:13:15Z

KofTwentyTwo commented

2026-10-10 18:13:15 +00:00

(Migrated from github.com)

GitHub's native release notes are professional but use compact headings/lists and bare URLs. The regenerated release proposal failed Markdown lint after #23 because its changelog still allowed only the former renderer's spacing.

Scope native spacing, links and repeated-category exceptions to generated CHANGELOG.md; keep every other document's normal lint rules. Document this scope. Refs #21.

Validation: repository Markdown and offline internal links; actual generated release notes and a two-version fixture pass with the scoped directives. Required CI and recorded review must pass before merge. Substantial AI assistance: OpenAI GPT-6 Codex under maintainer authorization.

This correction does not merge the version proposal or publish a release.

GitHub's native release notes are professional but use compact headings/lists and bare URLs. The regenerated release proposal failed Markdown lint after #23 because its changelog still allowed only the former renderer's spacing. Scope native spacing, links and repeated-category exceptions to generated `CHANGELOG.md`; keep every other document's normal lint rules. Document this scope. Refs #21. Validation: repository Markdown and offline internal links; actual generated release notes and a two-version fixture pass with the scoped directives. Required CI and recorded review must pass before merge. Substantial AI assistance: OpenAI GPT-6 Codex under maintainer authorization. This correction does not merge the version proposal or publish a release.

KofTwentyTwo (Migrated from github.com) reviewed

2026-10-10 18:15:18 +00:00

KofTwentyTwo (Migrated from github.com) left a comment

Recorded AI review by OpenAI GPT-6 Codex under maintainer direction; not independent human approval.

Reviewed PR #24 source head fa15d5cd2a49732441de2013cb86f08d99181540 against base 435049d68822e3c529c751132d16729b115be776.

The original professional-text correction regenerated clean release notes but exposed native GitHub Markdown formatting incompatible with the former changelog directives. This follow-up changes only generated changelog directives and documents their scope. Spacing, bare URLs and repeated category headings are permitted only in CHANGELOG.md; normal documentation rules and internal-link checks remain intact. Version metadata, release permissions and publication are unchanged.

The actual regenerated changelog and a two-native-release fixture passed Markdown lint with these directives. All 69 repository Markdown files and offline internal links passed. No blocking finding remains; require all nine GitHub checks before the maintainer-authorized merge.

All nine required checks now pass in CI run 38074899308. A transient advisory API request failure in the workflow scanner passed on retry without code or gate changes. GitHub verifies the source signature as valid.

Recorded AI review by OpenAI GPT-6 Codex under maintainer direction; not independent human approval. Reviewed PR #24 source head `fa15d5cd2a49732441de2013cb86f08d99181540` against base `435049d68822e3c529c751132d16729b115be776`. The original professional-text correction regenerated clean release notes but exposed native GitHub Markdown formatting incompatible with the former changelog directives. This follow-up changes only generated changelog directives and documents their scope. Spacing, bare URLs and repeated category headings are permitted only in `CHANGELOG.md`; normal documentation rules and internal-link checks remain intact. Version metadata, release permissions and publication are unchanged. The actual regenerated changelog and a two-native-release fixture passed Markdown lint with these directives. All 69 repository Markdown files and offline internal links passed. No blocking finding remains; require all nine GitHub checks before the maintainer-authorized merge. All nine required checks now pass in [CI run 38074899308](https://github.com/KofTwentyTwo/standards/actions/runs/38074899308). A transient advisory API request failure in the workflow scanner passed on retry without code or gate changes. GitHub verifies the source signature as valid.

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: KofTwentyTwo/standards#24