1 files changed, 90 insertions, 0 deletions
diff --git a/testing/marionette/doc/NewContributors.md b/testing/marionette/doc/NewContributors.md
new file mode 100644
index 0000000000..5411b32862
--- /dev/null
+++ b/testing/marionette/doc/NewContributors.md
@@ -0,0 +1,90 @@
+New contributors
+================
+
+This page is aimed at people who are new to Mozilla and want to contribute
+to Mozilla source code related to Marionette Python tests, WebDriver
+spec tests and related test harnesses and tools. Mozilla has both
+git and Mercurial repositories, but this guide only describes Mercurial.
+
+If you run into issues or have doubts, check out the [Resources](#resources)
+section below and **don't hesitate to ask questions**. :) The goal of these
+steps is to make sure you have the basics of your development environment
+working. Once you do, we can get you started with working on an
+actual bug, yay!
+
+
+Accounts, communication
+-----------------------
+
+  1. Set up a [Bugzilla] account (and, if you like, a [Mozillians] profile).
+     Please include your Matrix nickname in both of these accounts so we can work
+     with you more easily. For example, Eve Smith would set the Bugzilla name
+     to "Eve Smith (:esmith)", where "esmith" is the Matrix nick.
+
+  2. For a direct communication with us it will be beneficial to setup [Matrix].
+     Make sure to also register your nickname as described in the linked document.
+
+  3. Join our #interop channel, and introduce yourself to the team. :jgraham,
+     :maja_zf, and :whimboo are all familiar with Marionette.
+     We're nice, I promise, but we might not answer right away due to different
+     time zones, time off, etc. So please be patient.
+
+  4. When you want to ask a question on Matrix, just go ahead an ask it even if
+     no one appears to be around/responding.
+     Provide lots of detail so that we have a better chance of helping you.
+     If you don't get an answer right away, check again in a few hours --
+     someone may have answered you in the mean time.
+
+  5. If you're having trouble reaching us over Matrix, you are welcome to send an
+     email to our [mailing list](index.html#communication) instead. It's a good
+     idea to include your Matrix nick in your email message.
+
+[Matrix]: https://chat.mozilla.org
+[Bugzilla]: https://bugzilla.mozilla.org/
+[Mozillians]: https://mozillians.org/
+[logbot]: https://mozilla.logbot.info/ateam/
+
+Getting the code, running tests
+-------------------------------
+
+Follow the documentation on [Contributing](Contributing.html) to get a sense of
+our projects, and which is of most interest for you. You will also learn how to
+get the Firefox source code, build your custom Firefox build, and how to run the
+tests.
+
+
+Work on bugs and get code review
+--------------------------------
+
+Once you are familiar with the code of the test harnesses, and the tests you might
+want to start with your first contribution. The necessary steps to submit and verify
+your patches are laid out in [Patches.md](Patches.html).
+
+
+Resources
+---------
+
+  * Search Mozilla's code repositories with [searchfox].
+
+  * Another [guide for new contributors].  It has not been updated in a long
+    time but it's a good general resource if you ever get stuck on something.
+    The most relevant sections to you are about Bugzilla, Mercurial, Python and the
+    Development Process.
+
+  * [Mercurial for Mozillians]
+
+  * More general resources are available in this little [guide] :maja_zf wrote
+    in 2015 to help a student get started with open source contributions.
+
+  * Textbook about general open source practices: [Practical Open Source Software Exploration]
+
+  * If you'd rather use git instead of hg, see [git workflow for
+    Gecko development] and/or [this blog post by :ato].
+
+[searchfox]: https://searchfox.org/mozilla-central/source/testing/marionette/
+[guide for new contributors]: https://ateam-bootcamp.readthedocs.org/en/latest/guide/index.html#new-contributor-guide
+[Mercurial for Mozillians]: https://mozilla-version-control-tools.readthedocs.org/en/latest/hgmozilla/index.html
+[guide]: https://gist.github.com/mjzffr/d2adef328a416081f543
+[Practical Open Source Software Exploration]: https://quaid.fedorapeople.org/TOS/Practical_Open_Source_Software_Exploration/html/index.html
+[git workflow for Gecko development]: https://github.com/glandium/git-cinnabar/wiki/Mozilla:-A-git-workflow-for-Gecko-development
+[this blog post by :ato]: https://sny.no/2016/03/geckogit