diff --git a/CONTRIBUTING.rst b/CONTRIBUTING.rst index 455998b78..0474fa3a3 100644 --- a/CONTRIBUTING.rst +++ b/CONTRIBUTING.rst @@ -166,7 +166,7 @@ Short version #. Fork the repository. #. Enable and install `pre-commit `_ to ensure style-guides and code checks are followed. -#. Target ``master`` for bugfixes and doc changes. +#. Target ``master`` for bug fixes and doc changes. #. Target ``features`` for new features or functionality changes. #. Follow **PEP-8** for naming and `black `_ for formatting. #. Tests are run using ``tox``:: @@ -212,7 +212,7 @@ Here is a simple overview, with pytest-specific bits: $ git checkout -b your-feature-branch-name features - Given we have "major.minor.micro" version numbers, bugfixes will usually + Given we have "major.minor.micro" version numbers, bug fixes will usually be released in micro releases whereas features will be released in minor releases and incompatible changes in major releases. @@ -294,7 +294,7 @@ Here is a simple overview, with pytest-specific bits: compare: your-branch-name base-fork: pytest-dev/pytest - base: master # if it's a bugfix + base: master # if it's a bug fix base: features # if it's a feature diff --git a/HOWTORELEASE.rst b/HOWTORELEASE.rst index f15182e4c..b6b596ba2 100644 --- a/HOWTORELEASE.rst +++ b/HOWTORELEASE.rst @@ -1,7 +1,7 @@ Release Procedure ----------------- -Our current policy for releasing is to aim for a bugfix every few weeks and a minor release every 2-3 months. The idea +Our current policy for releasing is to aim for a bug-fix release every few weeks and a minor release every 2-3 months. The idea is to get fixes and new features out instead of trying to cram a ton of features into a release and by consequence taking a lot of time to make a new one. diff --git a/changelog/README.rst b/changelog/README.rst index adabc9ca1..0a819d74e 100644 --- a/changelog/README.rst +++ b/changelog/README.rst @@ -15,7 +15,7 @@ Each file should be named like ``..rst``, where * ``feature``: new user facing features, like new command-line options and new behavior. * ``improvement``: improvement of existing functionality, usually without requiring user intervention (for example, new fields being written in ``--junitxml``, improved colors in terminal, etc). -* ``bugfix``: fixes a reported bug. +* ``bugfix``: fixes a bug. * ``doc``: documentation improvement, like rewording an entire session or adding missing docs. * ``deprecation``: feature deprecation. * ``removal``: feature removal. diff --git a/doc/en/changelog.rst b/doc/en/changelog.rst index 0bda6bb54..e0a2495cc 100644 --- a/doc/en/changelog.rst +++ b/doc/en/changelog.rst @@ -2357,7 +2357,7 @@ Deprecations and Removals - `#4036 `_: The ``item`` parameter of ``pytest_warning_captured`` hook is now documented as deprecated. We realized only after the ``3.8`` release that this parameter is incompatible with ``pytest-xdist``. - Our policy is to not deprecate features during bugfix releases, but in this case we believe it makes sense as we are + Our policy is to not deprecate features during bug-fix releases, but in this case we believe it makes sense as we are only documenting it as deprecated, without issuing warnings which might potentially break test suites. This will get the word out that hook implementers should not use this parameter at all. @@ -5380,7 +5380,7 @@ time or change existing behaviors in order to make them less surprising/more use Thanks Daniel Grunwald for the report and Bruno Oliveira for the PR. - (experimental) adapt more SEMVER style versioning and change meaning of - master branch in git repo: "master" branch now keeps the bugfixes, changes + master branch in git repo: "master" branch now keeps the bug fixes, changes aimed for micro releases. "features" branch will only be released with minor or major pytest releases. diff --git a/doc/en/development_guide.rst b/doc/en/development_guide.rst index 649419316..31fc2c438 100644 --- a/doc/en/development_guide.rst +++ b/doc/en/development_guide.rst @@ -19,7 +19,7 @@ Branches We have two long term branches: -* ``master``: contains the code for the next bugfix release. +* ``master``: contains the code for the next bug-fix release. * ``features``: contains the code with new features for the next minor release. The official repository usually does not contain topic branches, developers and contributors should create topic diff --git a/scripts/release.patch.rst b/scripts/release.patch.rst index e73d91768..b1ad2dbd7 100644 --- a/scripts/release.patch.rst +++ b/scripts/release.patch.rst @@ -3,7 +3,7 @@ pytest-{version} pytest {version} has just been released to PyPI. -This is a bug fix release, being a drop-in replacement. To upgrade:: +This is a bug-fix release, being a drop-in replacement. To upgrade:: pip install --upgrade pytest