Skip to content

Doc: Add version rule to avoid surpises#249

Merged
tomschr merged 1 commit intopython-semver:masterfrom
tomschr:feature/doc-release-policy
May 13, 2020
Merged

Doc: Add version rule to avoid surpises#249
tomschr merged 1 commit intopython-semver:masterfrom
tomschr:feature/doc-release-policy

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