Versions of pinax-models should be tagged in GitHub

[JordanReiter]

The "current" version of pinax-models (e.g. what you get when you use pip install pinax-models) appears to date back to a much earlier version of the code. As such, it would be useful to be able to reference, instead, an updated version of the code in a requirements.txt file.

However, there are currently no tags for the various versions, only the master branch. As a result, it is possible (indeed, I have had it happen for other github repos) that if the master branch of pinax-models were used as a requirement for a deployed server, the server could break the next time it was deployed if there were an error or problem in the source code.

Instead, we should have tagged versions of the code, so that we can indicate which version we want to use when pulling in the code from github.

Also, version numbers should be incremented when significant changes are made to the code. For example, the code for deleting related objects has changed substantially from code for 2.0 but the version number is still 2.0.

[jtauber]

One can always use commit SHAs so tags aren't strictly necessary, but agree we need to tag releases (and make sure we do them regularly).

For related reasons, we always recommend pinning requirements (to released versions if possible but to SHAs at the very least, rather than just HEAD)

[JordanReiter]

For related reasons, we always recommend pinning requirements (to released versions if possible but to SHAs at the very least, rather than just HEAD)

Understood. Note that I believe the released version of pinax-models is faulty when deleting certain records, which is part of the problem.

Also something like
-e git+https://github.com/pinax/[email protected]#…
is so much cleaner and readable than
-e git+https://github.com/pinax/pinax-models.git@19c5031a4586436b9f023183adea2daa#…
It also gives a better hint to the version you want. So if you make a bug fix for a particular version I can tell whether it applies to me or not.

[JordanReiter]

If you need help with the tagging, let me know. Thanks.