Ver código fonte

developers docs: clarify how to choose PR target branch

Thomas Waldmann 8 anos atrás
pai
commit
c81f861ba6
1 arquivos alterados com 10 adições e 3 exclusões
  1. 10 3
      docs/development.rst

+ 10 - 3
docs/development.rst

@@ -21,9 +21,16 @@ Some guidance for contributors:
 
 - choose the branch you base your changesets on wisely:
 
-  - choose x.y-maint for stuff that should go into next x.y release
-    (it usually gets merged into master branch later also)
-  - choose master if that does not apply
+  - choose x.y-maint for stuff that should go into next x.y.z release
+    (it usually gets merged into master branch later also), like:
+
+    - bug fixes (code or docs)
+    - missing *important* (and preferably small) features
+    - docs rearrangements (so stuff stays in-sync to avoid merge
+      troubles in future)
+  - choose master if that does not apply, like for:
+
+    - developping new features
 
 - do clean changesets: