Feedback: Section 5. Versioning

[f-allian]

No description provided.

[f-allian]

• Figure caption: The framework of semantic versioning is described by three version numbers, major, minor and patch.

[f-allian]

• Version control vs versioning (diagram)

[f-allian]

• Put versioning section into preparing to publish Section

• manual publishing to PyPI

• separate section on GitHub automating

[ns-rse]

Poetry is introduced but there are multiple options available (see list below). Up to this point most things have been done without package management tools and versioning can be massively simplified and dynamically controlled via setuptools_scm independent of a package management tool. I think its good to teach basics without introducing additional frameworks/tools which whilst they might simplify workflows they often have an overhead of learning and it raises questions of why use one of another.

Alternatives to Poetry are...

• PDM
• Hatch
• Rye