summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorBruno Oliveira <nicoddemus@gmail.com>2017-09-14 19:37:08 -0300
committerBruno Oliveira <nicoddemus@gmail.com>2017-09-14 19:58:56 -0300
commit810320f591d3c309f89acbd7ab4de15cd7250256 (patch)
tree3f9ffd5704e3bc8e0290e11c9f5a5dcd0b476fe2 /doc
parent25d2acbdb2ffe8d38cda9bfe1a61ff9d2d4386c0 (diff)
downloadpytest-810320f591d3c309f89acbd7ab4de15cd7250256.tar.gz
Small fixes to development_guide: title and label names
* Fix title to use a proper "title" section marker * Fix labels by adding a " " after the ":" * Fix OS labels after obvious mishap * Sort labels
Diffstat (limited to 'doc')
-rw-r--r--doc/en/development_guide.rst47
1 files changed, 26 insertions, 21 deletions
diff --git a/doc/en/development_guide.rst b/doc/en/development_guide.rst
index 64a2923b6..465e97de0 100644
--- a/doc/en/development_guide.rst
+++ b/doc/en/development_guide.rst
@@ -1,5 +1,6 @@
+=================
Development Guide
------------------
+=================
Some general guidelines regarding development in pytest for core maintainers and general contributors. Nothing here
is set in stone and can't be changed, feel free to suggest improvements or changes in the workflow.
@@ -41,42 +42,46 @@ Here is a list of labels and a brief description mentioning their intent.
**Type**
-* ``type:bug``: problem that needs to be addressed.
-* ``type:backward compatibility``: issue that will cause problems with old pytest versions.
-* ``type:deprecation``: feature that will be deprecated in the future.
-* ``type:docs``: documentation missing or needing clarification.
-* ``type:enhancement``: new feature or API change, should be merged into ``features``.
-* ``type:feature-branch``: new feature or API change, should be merged into ``features``.
-* ``type:infrastructure``: improvement to development/releases/CI structure.
-* ``type:performance``: performance or memory problem/improvement.
-* ``type:proposal``: proposal for a new feature, often to gather opinions or design the API around the new feature.
-* ``type:question``: question regarding usage, installation, internals or how to test something.
-* ``type:refactoring``: internal improvements to the code.
-* ``type:regression``: indicates a problem that was introduced in a release which was working previously.
+* ``type: backward compatibility``: issue that will cause problems with old pytest versions.
+* ``type: bug``: problem that needs to be addressed.
+* ``type: deprecation``: feature that will be deprecated in the future.
+* ``type: docs``: documentation missing or needing clarification.
+* ``type: enhancement``: new feature or API change, should be merged into ``features``.
+* ``type: feature-branch``: new feature or API change, should be merged into ``features``.
+* ``type: infrastructure``: improvement to development/releases/CI structure.
+* ``type: performance``: performance or memory problem/improvement.
+* ``type: proposal``: proposal for a new feature, often to gather opinions or design the API around the new feature.
+* ``type: question``: question regarding usage, installation, internals or how to test something.
+* ``type: refactoring``: internal improvements to the code.
+* ``type: regression``: indicates a problem that was introduced in a release which was working previously.
**Status**
-* ``status:critical``: grave problem or usability issue that affects lots of users.
-* ``status:easy``: easy issue that is friendly to new contributors.
-* ``status:help wanted``: core developers need help from experts on this topic.
-* ``status:needs information``: reporter needs to provide more information; can be closed after 2 or more weeks of inactivity.
+* ``status: critical``: grave problem or usability issue that affects lots of users.
+* ``status: easy``: easy issue that is friendly to new contributors.
+* ``status: help wanted``: core developers need help from experts on this topic.
+* ``status: needs information``: reporter needs to provide more information; can be closed after 2 or more weeks of inactivity.
**Topic**
* ``topic: collection``
* ``topic: fixtures``
* ``topic: parametrize``
-* ``topic: selection``
* ``topic: reporting``
+* ``topic: selection``
* ``topic: tracebacks``
**Plugin (internal or external)**
-* ``plugin: junitxml``
* ``plugin: cache``
* ``plugin: capture``
* ``plugin: doctests``
+* ``plugin: junitxml``
+* ``plugin: monkeypatch``
+* ``plugin: nose``
+* ``plugin: pastebin``
* ``plugin: pytester``
+* ``plugin: tmpdir``
* ``plugin: unittest``
* ``plugin: warnings``
* ``plugin: xdist``
@@ -87,9 +92,9 @@ Here is a list of labels and a brief description mentioning their intent.
Issues specific to a single operating system. Do not use as a means to indicate where an issue originated from, only
for problems that happen **only** in that system.
+* ``os: linux``
+* ``os: mac``
* ``os: windows``
-* ``linux: windows``
-* ``mac: windows``
**Temporary**