-----BEGIN PGP SIGNED MESSAGE----- Hash: SHA1
Hello all!
As we have introduced version numbers into the code with [1] and [2], namely '1.0b1' and '2.0b1' I want to mention that we should agree on a version numbering philosophy. I assume the 'b1' stands for 'beta relase 1' is that correct? Why beta?
[1] https://git.wikimedia.org/blame/pywikibot%2Fcompat/HEAD/pywikibot%2F__init__... [2] https://git.wikimedia.org/blame/pywikibot%2Fcore/HEAD/pywikibot%2F__init__.p...
I would propose to use Semantic Versioning 2.0.0 [3] that would allow us to express backwards compatible and incompatible API changes in the version number also and for a project like ours, that would be very useful.
And then we should also discuss about whether to use 'git describe' for version numbering instead of this '__release__' variable (that should be called '__version__' acording to some PEP - braking backward compatibility)
Any sugestions? Ideas?
Thanks and Greetings DrTrigon
Hey,
I suggest looking at what the standard approach for this in the Python world. In particular, what tools such as the Python Package Index recommend. Basically the Python equivalent of http://getcomposer.org/doc/02-libraries.md#specifying-the-version
Cheers
-- Jeroen De Dauw http://www.bn2vs.com Don't panic. Don't be evil. ~=[,,_,,]:3 --
On 6 October 2013 10:52, Dr. Trigon dr.trigon@surfeu.ch wrote:
As we have introduced version numbers into the code with [1] and [2], namely '1.0b1' and '2.0b1' I want to mention that we should agree on a version numbering philosophy. I assume the 'b1' stands for 'beta relase 1' is that correct? Why beta?
Because both are in 'perpetual beta'.
I would propose to use Semantic Versioning 2.0.0 [3] that would allow us to express backwards compatible and incompatible API changes in the version number also and for a project like ours, that would be very useful.
It only makes sense to use semantic version numbers if we actually do releases. I'm not against doing that, but I'm not sure if it's really worth the effort, especially considering how people typically use pywikibot.
And then we should also discuss about whether to use 'git describe'
for version numbering instead of this '__release__' variable (that should be called '__version__' acording to some PEP - braking backward compatibility)
If you want to do proper versioning, __version__ should be the version number (and thus not be derived from git -- you bump it manually to a newer version).
Merlijn