You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@cordova.apache.org by Apache Wiki <wi...@apache.org> on 2013/07/08 21:52:19 UTC
[Cordova Wiki] Update of "CommitterWorkflow" by MarcelKinard
Dear Wiki user,
You have subscribed to a wiki page or wiki category on "Cordova Wiki" for change notification.
The "CommitterWorkflow" page has been changed by MarcelKinard:
https://wiki.apache.org/cordova/CommitterWorkflow?action=diff&rev1=20&rev2=21
Comment:
added verbage about test expectations
* For small changes, private topic branches are preferred.
* Note: You should never rebase a public topic branch!
+ == Step 4: Make your changes ==
+ * Thank you for making the world a better place.
+
+ == Step 5: Test your changes ==
+ * The author is responsible to test their own changes and correct any problems with their changes before a pull request is submitted (contributor authored) or it lands in the stream (committer authored). The testing includes both verifying the function they added/touched, plus running the test suites to verify there are no regressions.
+ * When we say "run the test suites" this includes all automated tests in mobile-spec, manual tests in mobile-spec that might be affected by the change, and any platform-specific unit tests (i.e., cordova-android/test, cordova-ios/CordovaLibTests, etc.)
+ * It is recommended to add a short comment to the Jira item stating what testing you did.
+ * It is recommended that where reasonably feasible, you add automated tests to validate your change and catch any future regressions.
+
- == Step 4: Ask for a code review ==
+ == Step 6: Ask for a code review ==
* If you are using a public topic branch, then you should ask for a code review when you consider it to be complete.
* Use [[http://reviews.apache.org/|reviews.apache.org]] to create a review request.
* By default, the ML will be notified of your review request.
* If you have someone in particular that you would like approval from, be sure to add them in "People" field of the review.
- == Step 5: Merge your change ==
+ == Step 7: Merge your change ==
* Once your topic branch is tested & working, it's time to merge it.
* Rebase & commit it to master. If it fixes a regression, then also cherry-pick it into the appropriate release branch.
* Here is an example workflow for committing a change:
@@ -83, +92 @@
Note also that the timestamp on a commit will be unchanged by a rebase, but that it will appear "out of order" in git log. This is because git log is not chronological order, but in order of the `parent` chain of the commits.
- == Step 6: Update JIRA ==
+ == Step 8: Update JIRA ==
Mark the relevant JIRA as fixed, and be sure to include the relevant commit IDs.
@@ -92, +101 @@
== Step 1: Review the change ==
* View the user's branch in github and request changes be made (if applicable) by adding comments in the web interface
+ * Verify that the contributor tested it, per the test guidelines above.
== Step 2: Ensure that they have signed the Contributor Agreement ==
* For trivial changes, this is not necessary.