summaryrefslogtreecommitdiffstats
path: root/testing/marionette/doc/Patches.md
diff options
context:
space:
mode:
Diffstat (limited to 'testing/marionette/doc/Patches.md')
-rw-r--r--testing/marionette/doc/Patches.md33
1 files changed, 33 insertions, 0 deletions
diff --git a/testing/marionette/doc/Patches.md b/testing/marionette/doc/Patches.md
new file mode 100644
index 0000000000..7e5ece9fd3
--- /dev/null
+++ b/testing/marionette/doc/Patches.md
@@ -0,0 +1,33 @@
+Submitting patches
+==================
+
+You can submit patches by using [Phabricator]. Walk through its documentation
+in how to set it up, and uploading patches for review. Don't worry about which
+person to select for reviewing your code. It will be done automatically.
+
+Please also make sure to follow the [commit creation guidelines].
+
+Once you have contributed a couple of patches, we are happy to
+sponsor you in [becoming a Mozilla committer]. When you have been
+granted commit access level 1 you will have permission to use the
+[Firefox CI] to trigger your own “try runs” to test your changes.
+
+This is a good try syntax to use when testing Marionette changes:
+
+ -b do -p linux,linux64,macosx64,win64,android-api-16 -u marionette,marionette-headless,xpcshell,web-platform-tests,firefox-ui-functional -t none
+
+You can also use the `marionette` [try preset]:
+
+ mach try --preset marionette
+
+This preset will schedule Marionette-related tests on various platforms. You can
+reduce the number of tasks by filtering on platforms (e.g. linux) or build type
+(e.g. opt):
+
+ mach try --preset marionette -xq "'linux 'opt"
+
+[Phabricator]: https://moz-conduit.readthedocs.io/en/latest/phabricator-user.html
+[commit creation guidelines]: https://mozilla-version-control-tools.readthedocs.io/en/latest/devguide/contributing.html?highlight=phabricator#submitting-patches-for-review
+[becoming a Mozilla committer]: https://www.mozilla.org/en-US/about/governance/policies/commit/
+[Firefox CI]: https://treeherder.mozilla.org/
+[try preset]: https://firefox-source-docs.mozilla.org/tools/try/presets.html