8000 Professional changelog (Keep a Changelog), README, CLI help and troubleshooting (missed commit of #153) by rafatahmed · Pull Request #154 · rafatahmed/Flahax · GitHub
[go: up one dir, main page]

Skip to content

Professional changelog (Keep a Changelog), README, CLI help and troubleshooting (missed commit of #153) - #154

Merged
rafatahmed merged 1 commit into
mainfrom
docs/professional-docs
Oct 23, 2026
Merged

rafatahmed merged 1 commit into
mainfrom
docs/professional-docs

Conversation

@rafatahmed
Copy link
Copy Markdown
Owner

This carries the last commit of #153, which reached the branch after #153 had been merged and closed, so it is not on main yet. The commit is unchanged (cherry-picked onto the current main). The description of #153 covers it in full; in short:

  • Changelog: Keep a Changelog 1.1.0 for every release.
    • ## [Unreleased] comes first, and every release is headed ## [X.Y.Z] - YYYY-MM-DD (0.3.0 is [YANKED]).
    • Each release opens with a short paragraph, then uses the six change types with short bullets, plus comparison links at the bottom.
    • The full text of 0.5.0, 0.4.0 and 0.3.1 moves unchanged to docs/releases/.
    • tests/test_changelog.py checks every release, and CONTRIBUTING states the rule.
  • CLI help (clig.dev). flahax --help describes every command, with examples and links to the documentation and the issue tracker; the start screen links the documentation. Behaviour is unchanged.
  • Troubleshooting. The user guide covers installing and upgrading (Upgrading from main with pip --upgrade keeps the old files while the version stays 0.6.0.dev0 #134) and the full-screen flahax mix; the README links it.
  • README (PyPA). It follows the order a reader needs: installation, quick start, commands, what it does, documentation, troubleshooting, verification and limits, contributing, citation, credits, license. twine check --strict passes.

Checks

- CHANGELOG.md follows Keep a Changelog 1.1.0 for every release: [Unreleased] first,
  "## [X.Y.Z] - YYYY-MM-DD" headings ([YANKED] for 0.3.0), the six change types, short
  bullets, and comparison links. The full text of 0.5.0, 0.4.0 and 0.3.1 moves unchanged
  to docs/releases/. tests/test_changelog.py enforces the format; CONTRIBUTING states it.
- flahax --help describes every command, with examples and links to the documentation
  and the issue tracker (clig.dev); the start screen links the documentation.
- The user guide gains troubleshooting for installing and upgrading (#134) and for the
  full-screen flahax mix; the README links it.
- The README follows the order a reader needs: installation, quick start (flahax mix,
  flahax batch, Python), commands, what it does, documentation, troubleshooting,
  verification and limits, contributing, citation, credits, license. twine check --strict
  passes.
@rafatahmed rafatahmed self-assigned this Oct 23, 2026
@read-the-docs-community
Copy link
Copy Markdown

Documentation build overview

📚 Flahax | 🛠️ Build #35364890 | 📁 Comparing 1736405 against latest (3160a9f)

  🔍 Preview build  

2 files changed
± changelog.html
± guide/manual.html

@rafatahmed
rafatahmed marked this pull request as draft October 23, 2026 20:26
@codecov-commenter
Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 89.82%. Comparing base (3160a9f) to head (1736405).

Additional details and impacted files
@@           Coverage Diff           @@
##             main     #154   +/-   ##
=======================================
  Coverage   89.81%   89.82%           
=======================================
  Files          54       54           
  Lines        7367     7371    +4     
=======================================
+ Hits         6617     6621    +4     
  Misses        750      750           
Flag Coverage Δ
unittests 89.82% <100 8000 .00%> (+<0.01%) ⬆️

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Harness.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:
  • ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

@rafatahmed
rafatahmed marked this pull request as ready for review October 23, 2026 20:41
@rafatahmed
rafatahmed merged commit 37fb4e6 into main Oct 23, 2026
10 checks passed
@rafatahmed
rafatahmed deleted the docs/professional-docs branch October 23, 2026 21:04
rafatahmed added a commit that referenced this pull request Nov 7, 2026
Professional changelog (Keep a Changelog), README, CLI help and troubleshooting (missed commit of #153)
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.

2 participants

0