Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Doc: Add version rule to avoid surpises #249

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

Merged
merged 1 commit into from
May 13, 2020

Conversation

tomschr
Copy link
Member

@tomschr tomschr commented May 10, 2020

This PR is not based on any specific issue. It's a doc-only addition.


Add a new section "Release Policy" to give a recommendation for users who wants to stay for major release 2.

As with the upcoming major 3 release of semver, a lot of things have been changed. To avoid any surprises for our users or even break their code base, a short version restriction can solve that.

Basically, it boils down to a line like semver>=2,<3. This can be added in any file which lists dependencies.

@tomschr tomschr added Doc Documentation related issue Enhancement Not a bug, but increases or improves in value, quality, desirability, or attractiveness labels May 10, 2020
@tomschr tomschr requested a review from a team May 10, 2020 14:58
@tomschr tomschr self-assigned this May 10, 2020
Add a new section "Release Policy" to give a
recommendation.

As with the upcoming major 3 release of semver, a lot of
things have been changed. To avoid any surprises for
our users or even break their code base, a short
version restriction can solve that.

This should help users who wants to stay with release 2.

Basically, it boils down to a line like `semver>=2,<3`.
This can be added in any file which lists dependencies.
@tomschr tomschr force-pushed the feature/doc-release-policy branch from c519d39 to 028f6b1 Compare May 13, 2020 18:27
@tomschr tomschr merged commit 0733da7 into python-semver:master May 13, 2020
@tomschr tomschr deleted the feature/doc-release-policy branch May 13, 2020 19:04
tomschr added a commit to tomschr/python-semver that referenced this pull request May 13, 2020
* Update CHANGELOG
* Improve release-procedure.md
* python-semver#249: Add release policy and version restriction in documentation to
  help our users which would like to stay on the major 2 release.
* python-semver#250: Simplify installation semver on openSUSE with ``obs://``.
* python-semver#251: Return type of ``semver.VersionInfo.next_version``
  to always return a ``VersionInfo`` instance.
* python-semver#256: Made docstrings consistent
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
Doc Documentation related issue Enhancement Not a bug, but increases or improves in value, quality, desirability, or attractiveness
Projects
None yet
Development

Successfully merging this pull request may close these issues.

1 participant
Morty Proxy This is a proxified and sanitized view of the page, visit original site.