Skip to content

Releasing#

We follow Semantic Versioning and Keep a Changelog.

  • SemVer → https://semver.org/
  • Keep a Changelog → https://keepachangelog.com/en/1.1.0/

Checklist#

  1. Finish code/docs
  2. README shows pip install netbox-aci-plugin.
  3. docs/index.md Installing & Compatibility are correct.
  4. Changelog
  5. Add ## X.Y.Z – YYYY-MM-DD with Added / Changed / Fixed / Compatibility.
  6. Version bump
  7. pyproject.toml → version = "X.Y.Z".
  8. Tag
  9. git tag vX.Y.Z && git push origin vX.Y.Z
  10. CI
  11. Build wheel+sdist, twine check, publish to PyPI (Trusted Publishing), draft GitHub Release with only the current section from the changelog.
  12. Publish Release
  13. Review the draft notes and click Publish.
  14. Post-release
  15. Verify the PyPI page renders the README.
  16. Announce compatibility (NetBox 4.3) if it changed.