Add section on package version management in README

README.md

@@ -106,7 +106,19 @@ patch -p1 -d $KAPITAN_VENV < hack/kapitan_0.32_reclass_rs.patch
 
 Please note that we've only tested the patch against the Kapitan 0.32 release as published on PyPI.
 
+## Automated package version management
+
+We generate the package version of `reclass-rs` from the latest Git tag when building Python wheels.
+To ensure this always works, we keep the base version in `Cargo.toml` as `0.0.0`.
+
+For tag builds, the generated version matches the tag.
+For PR and branch builds, the generated version is `git describe --tags --always --match=v*` without the component derived from the commit hash.
+
+The version is injected with [cargo-edit]'s `cargo set-version` before the Python wheels are built.
+
+See the ["Python" workflow](./.github/workflows/python.yml) for more details.
 
 [rustup]: https://rustup.rs/
 [maturin]: https://github.com/PyO3/maturin
 [Kapitan]: https://kapitan.dev
+[cargo-edit]: https://github.com/killercup/cargo-edit