Skip to content

docs: add CHANGELOG.md and a docs-update policy - #45

Merged
kreczko merged 1 commit into
mainfrom
docs/changelog-and-policy
Oct 26, 2026
Merged

kreczko merged 1 commit into
mainfrom
docs/changelog-and-policy

Conversation

@kreczko

@kreczko kreczko commented Oct 26, 2026

Copy link
Copy Markdown
Collaborator

Summary

cli/
├── CHANGELOG.md   (new — Keep a Changelog format, calendar-versioned)
└── AGENTS.md       (modified — new "Documentation and Changelog" section)

Part of a workspace-wide rollout (see FAST-HEP/fasthep-dev, task 2026-10-26-package-docs-rollout) giving every FAST-HEP package a real CHANGELOG.md and a stated policy for keeping it current. No docs/ tree exists here yet, so no Sphinx page is added (the AGENTS.md entry says so explicitly).

CHANGELOG.md is backfilled with real content: a ## [2026.08.2] section covering the last tagged release, and a populated ## [Unreleased] section covering the fasthep-toolbench[display,http] extras change and the progress-typing fix.

Evidence

Before: no CHANGELOG.md, no stated docs-update policy.
After: content verified by direct inspection against git log 2026.08.1..2026.08.2 and git log 2026.08.2..origin/main.

Merge Danger

Documentation-only. No source, test, or dependency changes. Zero behavioural risk.

AI-assisted contributions

This PR's content was generated by Claude (Sonnet 5), orchestrated by @kreczko across a multi-session workspace effort. What was AI-generated: the CHANGELOG.md content (synthesized from git log between tags, grouped into user-facing bullets, categorized per Keep a Changelog), and the AGENTS.md policy section (templated identically across all participating repos). What was reviewed: the repository owner read and approved the diff before pushing (this workspace's standard two-gate review: push, then PR). Known limitation: the CHANGELOG.md backfill is a best-effort reconstruction from commit history, not a release-time verbatim record.

🤖 Generated with Claude Code

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@kreczko
kreczko merged commit 6eaf0ea into main Oct 26, 2026
0 of 5 checks passed
@kreczko
kreczko deleted the docs/changelog-and-policy branch October 26, 2026 13:39
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant