Changes between Version 7 and Version 8 of en/patches

Timestamp:

Jun 16, 2014, 10:47:45 PM (7 years ago)

Author:

laurentj

Comment:

--

en/patches

@@ -21 +21 @@
 == Creating the patch ==
 
-There are 3 ways to provide patch, depending of how you work and how you contribute.
+There are two ways to provide patch, depending of how you work and how you contribute.
 
-=== You create occasionnaly a patch ===
+=== You create a tiny patch on a single file ===
 
-The simplier way for a beginner is to use "git diff". In the directory of your local copy of the repository, you should have made all your changes. When your changes are ok, just type:
+The simplier way for a beginner is to edit the file to change directly on github.
 
-  git diff > mypatch.diff
+ * Go on https://github.com/jelix/jelix/tree/master/ 
+ * select the oldest branch on which you want to fix the issue
+ * Navigate and display the file you want to modify
+ * Click on the "edit" button
+ * make your changes
+ * confirm etc: it will create a pull request for you.
 
-Then you have a mypatch.diff file.
+Your changes will then be reviewed by a core developer. He may ask some modifications. When it is ok, your changes will be integrated in the branch you selected, and the core developper will merge it in newer branches.
 
-If your modification has to be applied on stable branches, create the patch with the oldest branch.
 
-Submit the patch into a ticket on developer.jelix.org. The ticket can be an existing one, or perhaps you have to create it. Create/edit the ticket and attached the file. Then you have to request a review.  Choose "ask a review" on the ticket. Then a reviewer will verify your patch. If it is ok, the ticket will be "reviewed". If your patch needs some improvements, it will be  "assigned" again and the reviewer will ask to make some improvements. Then create a new patch, submit it on the ticket, "ask a review" again and so on. When it is ok, you can commit the patch in the repository if you have write acces, or a "commiter" will do it for you.
-
-=== You are an active contributor ===
+=== You are an active contributor or you want to propose a patch that have more one file ===
 
 If you provide often some patches (unrelated or not), or if you'are familiar with Git, the best way is to "fork" on Github.com. Please create a branch for each modification you want to provide, so we could merge them independently, after the review. As we would like to have a "clear" history, for little modifications, try to create only one commit, not 10 or 20 :-). For complex modifications, it's better of course to have several commit. Try to commit clear steps, in order to have an understandable history. Each changeset should correspond to a specific step of the change.
@@ -64 +66 @@
  * should be written in english
  * it should contain: 
-    - the "ticket #xxx" where xxx is the number of a ticket on developer.jelix.org.
+    - the "Refs #xxx" or "Closes #xxx" where xxx is the number of the issue on github.
     - the description of the change
-    - the reviewer name: "r=bob"
  * you must indicate the author of the patch with the -u option if you're not the author
 
 Example:
 {{{
-git commit -u "Bob <bob@example.local>" -m "ticket #68987 - added support of multiline tags in templates. r=laurent"
+git commit -u "Bob <bob@example.local>" -m "Added support of multiline tags in templates.
+
+Refs #4444"
 }}}