search

etclabscore / jade

[WIP] Jade - The next generation of web applications
Apache License 2.0
1 stars 1 forks source link

just a note on semver tags #4

Closed meowsbits closed 5 years ago

meowsbits commented 5 years ago

https://github.com/etclabscore/jade/blob/master/VERSIONING.md#summary

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.

I guess we should clarify if the PATCH increment should happen per release (that's what we've been doing) or "when you make [each] backwards-compatible bug fixes".

IMO incrementing PATCH per tagged release makes sense, since semver (and git) typically accomodate for v1.2.3-14-abbcdefa.

shanejonas commented 5 years ago

this is just copied for clarity out of the SEMVER spec. Also i'm not a huge fan of v prefixes, and metadata postfix. I've outline in that document that we should NOT use metadata, thoughts?

A Jade project MUST use Semantic Versioning semver. Build metadata MAY NOT be used in a jade project. Build metadata SHOULD be ignored.