-
Notifications
You must be signed in to change notification settings - Fork 144
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
initial draft of versioning guidelines #171
Conversation
docs/drafts/versioning.md
Outdated
|
||
The package maintenance group recommends that supported packages follow the issued NPM [best practices](https://docs.npmjs.com/about-semantic-versioning). Most packages that receive help are expected to already be following this guidance. However if a package is not already on a major semver release number we suggest that bumping up to version 1.0.0 on the next semver major release. | ||
|
||
It is also recommended that increasing the minimum required version of node is a breaking change and should be accompanied by major semver change. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
IMO it should be more than a recommendation, it's a must. Bumping major takes no effort and prevents major pains.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
The wording will be changed to make it a required practice
Co-Authored-By: ghinks <ghinks@yahoo.com>
Co-Authored-By: ghinks <ghinks@yahoo.com>
Co-Authored-By: ghinks <ghinks@yahoo.com>
reformatted and took on other comments which outdated request.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
LGTM
docs/drafts/versioning.md
Outdated
breaking change and should be accompanied by major semver change. | ||
- Release tag comments |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
what does this mean? Certainly there should be a semver tag on each published version - I’m not sure if this is what’s meant here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
the originator wanted comments on the tag.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it’s probably better called “release notes”.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
That would then be:
- release notes, in at least one of or possibly all of: in the commit message that bumps the version; in a changelog file in the version bump commit; in the tag annotation for the semver-tagged published commit.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
k, most reasonable.
Issue 158 versioning discourse has resulted in this brief advice for versioning. We are separating the versioning advice from the associated tooling that would or could enforce versioning.