[tor-commits] [sbws/master] fix: doc: Clarify branch to use when contributing

juga at torproject.org juga at torproject.org
Wed Aug 26 13:52:12 UTC 2020


commit ed835c416a2c75c055914e88c2daa7654b7df934
Author: juga0 <juga at riseup.net>
Date:   Tue Aug 11 15:45:03 2020 +0000

    fix: doc: Clarify branch to use when contributing
    
    Closes: #33473
---
 docs/source/contributing.rst | 11 ++++++++---
 1 file changed, 8 insertions(+), 3 deletions(-)

diff --git a/docs/source/contributing.rst b/docs/source/contributing.rst
index 0d41689..60602ad 100644
--- a/docs/source/contributing.rst
+++ b/docs/source/contributing.rst
@@ -51,9 +51,14 @@ Steps to create a MR
    Use ``pip install -e <>``
 5. If needed install the documentation and build it as explained in
    ./DOCUMENTATION.rst
-6. Create a new branch, named ``ticketXXX``.
-   Optionally, name it with a string explaining what it does,
-   ie ``ticketXXX_contributing``
+6. Create a new feature branch.
+   If the issue solves a bug, base the branch on the latest maintained version,
+   eg. ``maint-1.1`` and name it with the name of the base branch plus
+   ``_bugXXX``, where `XXX` is the number of the issue.
+   If the issue is a new feature, base the branch on the `master` branch and
+   name it ``ticketXXX``.
+   Optionally, the last part of the branch name can be any string, eg.
+   ``maint-1.1_bugXXX_contributing``.
 7. Write code (:ref:`codestyle-ref`), tests, documentation,
    extra files (:ref:`extrafiles-ref`), commit (:ref:`commits-ref`), etc.
 8. Ensure tests pass (./TESTING.rst).





More information about the tor-commits mailing list