Skip to content

Update docs for today's merges; add semver and release-process rules - #17

Merged
MeqdadDev merged 1 commit into
mainfrom
docs/update-changelog-and-release-process
Sep 12, 2026
Merged

MeqdadDev merged 1 commit into
mainfrom
docs/update-changelog-and-release-process

Conversation

@MeqdadDev

Copy link
Copy Markdown
Owner

Documentation:

Versioning/release process:

  • Added docs/releasing.md: semantic versioning rules (what bumps MAJOR vs MINOR vs PATCH for this package specifically), changelog discipline (add an entry in the same PR as the change), and a step-by-step release checklist (bump version, tag, GitHub Release, which triggers the existing publish.yml to PyPI). Linked from mkdocs.yml's nav and from docs/contribution.md.
  • Fixed a real version-tracking bug found while writing that doc: src/init.py's version said "1.2" while setup.py separately hardcoded "1.3.0" -- neither of which had actually been released (the latest tag is v1.2). setup.py now reads the version from src/init.py instead of duplicating it, so there's exactly one place to bump per release.

Verified: python setup.py --version resolves to 1.3.0 via the new single source of truth, mkdocs build --strict succeeds with no warnings, and classify_image.py in the tm-example test project still runs correctly end to end.

Documentation:
- CHANGELOG.md (and its mirror, docs/changelog.md) now covers the
  nested-Sequential .h5 loading fix and the Windows/Pillow annotation
  fixes merged today (PRs #13, #14, #16), not just the DepthwiseConv2D
  compat fix.
- README.md / docs/index.md "Compatibility" sections updated to mention
  both new fixes.
- docs/index.md's table of contents was missing links to the Changelog
  and Contributing pages despite both being in the mkdocs nav; added,
  plus a new Releasing page.

Versioning/release process:
- Added docs/releasing.md: semantic versioning rules (what bumps MAJOR
  vs MINOR vs PATCH for this package specifically), changelog discipline
  (add an entry in the same PR as the change), and a step-by-step release
  checklist (bump version, tag, GitHub Release, which triggers the
  existing publish.yml to PyPI). Linked from mkdocs.yml's nav and from
  docs/contribution.md.
- Fixed a real version-tracking bug found while writing that doc:
  src/__init__.py's __version__ said "1.2" while setup.py separately
  hardcoded "1.3.0" -- neither of which had actually been released
  (the latest tag is v1.2). setup.py now reads the version from
  src/__init__.py instead of duplicating it, so there's exactly one
  place to bump per release.

Verified: `python setup.py --version` resolves to 1.3.0 via the new
single source of truth, `mkdocs build --strict` succeeds with no
warnings, and classify_image.py in the tm-example test project still
runs correctly end to end.
@deepsource-io

deepsource-io Bot commented Sep 12, 2026

Copy link
Copy Markdown
Contributor

DeepSource Code Review

We reviewed changes in 28046b0...2eb9152 on this pull request. Below is the summary for the review, and you can see the individual issues we found as inline review comments.

See full review on DeepSource ↗

PR Report Card

Overall Grade   Security  

Reliability  

Complexity  

Hygiene  

Code Review Summary

Analyzer Status Updated (UTC) Details
Python Sep 12, 2026 6:33p.m. Review ↗

Important

AI Review is run only on demand for your team. We're only showing results of static analysis review right now. To trigger AI Review, comment @deepsourcebot review on this thread.

@MeqdadDev
MeqdadDev merged commit 4d04fdb into main Sep 12, 2026
6 checks passed
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