Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Semantic Versioning #4

Open
mansam opened this issue Apr 29, 2014 · 3 comments
Open

Semantic Versioning #4

mansam opened this issue Apr 29, 2014 · 3 comments

Comments

@mansam
Copy link

mansam commented Apr 29, 2014

Yo, so you should put some proper semantic version numbers on this thing so that people can keep their bindings up to date.

@TravisWhitaker
Copy link
Owner

How about something like: (long-term slowly-incrementing 'stable' number) dot (API change) dot (transparent implementation change)

@gambogi
Copy link

gambogi commented Apr 30, 2014

...or 6.(major version: large overhaul).(minor version: api change).(patch version: implementation change)

Because there's no way this is ever going to be anything but libPOLY 6.x.x.x

@mansam
Copy link
Author

mansam commented Apr 30, 2014

@TravisWhitaker that's actually pretty close to what capital-S Semantic Versioning is, which I'd recommend you use. For review purposes:

Given a version number MAJOR.MINOR.PATCH, increment the:
MAJOR version when you make incompatible API changes,
MINOR version when you add functionality in a backwards-compatible manner, and
PATCH version when you make backwards-compatible bug fixes.
Additional labels for pre-release and build metadata are available as extensions to the MAJOR.MINOR.PATCH format.

(SemVer also recommends keeping MAJOR at 0 during the initial flurry of development when nothing is stable, since otherwise it would be astronomically high by the time you were ready for what would have been a 1.0)

Naturally you can just prepend 6. to that whole thing and it still works.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

3 participants