[Author Prev][Author Next][Thread Prev][Thread Next][Author Index][Thread Index]

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



commit ed835c416a2c75c055914e88c2daa7654b7df934
Author: juga0 <juga@xxxxxxxxxx>
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).



_______________________________________________
tor-commits mailing list
tor-commits@xxxxxxxxxxxxxxxxxxxx
https://lists.torproject.org/cgi-bin/mailman/listinfo/tor-commits