Skip to main content

Local CLI and desktop checker for release note readiness gaps

Project description

Release Note Readiness desktop preview

Release Note Readiness Desk

Release Note Readiness Desk checks changelog drafts, PR summaries, and release-note copy for gaps that usually cause avoidable release confusion: missing migration steps, unclear customer impact, vague bullets, unresolved placeholders, absent validation evidence, and missing rollback notes.

It runs locally as a CLI or a small Tkinter desktop app. There are no runtime dependencies.

Install

python3 -m pip install release-note-readiness-desk

CLI

release-note-readiness examples/release-draft.md
release-note-readiness examples/release-draft.md --format html --output readiness.html
release-note-readiness CHANGELOG.md --fail-under 80 --fail-on-high

Read from stdin:

cat CHANGELOG.md | release-note-readiness --format json

Desktop App

release-note-readiness-gui

Paste a draft, click Check, then copy or save the Markdown report.

What It Checks

  • Breaking or high-risk changes without migration guidance
  • Risky changes without customer impact language
  • Missing validation or rollout evidence
  • Missing rollback, revert, or feature-flag notes
  • Draft placeholders such as TODO or TBD
  • Vague entries like "minor updates" or "various fixes"
  • Missing standard release-note categories

Development

python3 -m unittest discover -s tests
python3 -m build --no-isolation
python3 -m twine check dist/*

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

release_note_readiness_desk-0.1.0.tar.gz (11.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

release_note_readiness_desk-0.1.0-py3-none-any.whl (10.3 kB view details)

Uploaded Python 3

File details

Details for the file release_note_readiness_desk-0.1.0.tar.gz.

File metadata

File hashes

Hashes for release_note_readiness_desk-0.1.0.tar.gz
Algorithm Hash digest
SHA256 9bc08bff39dcdefd64121ba45d22325b430bf79e0c19580a6f33ebf2e76e2fd6
MD5 33b01992892b2e2b01320c77cca3bed6
BLAKE2b-256 aedf01209a49ae34be90be66ab58ef81abd3e74fa2eea697eee875b73126f01b

See more details on using hashes here.

File details

Details for the file release_note_readiness_desk-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for release_note_readiness_desk-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 7c451f4cc70730a594cdc21ec422af1239c127b6a6b98641580b436229b14f57
MD5 fa7d2383e1ad3b98f61050e01bc54eaf
BLAKE2b-256 cc706ee2b5a5e3400fb0f2e8f5161681ac0159dfc0ad988797173bfee344fc35

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page