Bug 1606990 - Simplify intro text and lighten tone r=pbro
authorvictoria <victoria@mozilla.com>
Fri, 24 Jan 2020 13:16:35 +0000
changeset 511646 1d0f06d1271bbb820c798263be01b618babea628
parent 511645 6d881ac5d2da41f5742859c7b6e36e6cf09839a6
child 511647 269b833e19daf02525ae00d595774f523261494b
push id37053
push usernbeleuzu@mozilla.com
push dateFri, 24 Jan 2020 21:46:30 +0000
treeherdermozilla-central@6f6e201853c8 [default view] [failures only]
perfherder[talos] [build metrics] [platform microbench] (compared to previous push)
reviewerspbro
bugs1606990
milestone74.0a1
first release with
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
last release without
nightly linux32
nightly linux64
nightly mac
nightly win32
nightly win64
Bug 1606990 - Simplify intro text and lighten tone r=pbro https://github.com/firefox-devtools/ux/issues/70 Differential Revision: https://phabricator.services.mozilla.com/D58878
devtools/docs/README.md
--- a/devtools/docs/README.md
+++ b/devtools/docs/README.md
@@ -1,21 +1,17 @@
-# Firefox Developer Tools
+# Firefox Developer Tools: Contributor Docs
 
-**NOTE:** This is the documentation *for working on* the Developer Tools. If you are looking for help with *using* the tools, please check out [the end user documentation](https://developer.mozilla.org/en-US/docs/Tools) instead.
+Note: This is a guide to working on code contributions to DevTools. If you're looking for help with using the tools, view the [user docs](https://developer.mozilla.org/en-US/docs/Tools) instead. For other ways to get involved, see our [community site](https://firefox-dev.tools).
 
 ---
 
-**Hello!**
-
-First of all, **thank you for making it this far!**
+**Hello,** and thanks for your interest in contributing to Firefox DevTools! 
 
-Developer Tools is a complex web application, and learning the code base will take some time, even if you're a very experienced contributor to other projects. 
+DevTools is a complex web app, but if you're familiar with either HTML/CSS or JavaScript, you can create a patch!
 
-Likewise, getting and building the code locally, sending contributions for review, and other essential tasks can take a bit longer and be a bit different from what you're used to seeing.
+The initial setup process of building Firefox can take a while. If you get stuck at any point, you can ask for help on the [DevTools Slack](https://devtools-html-slack.herokuapp.com/). 
 
-But there are good news: most of the initial, lengthy tasks don't need to be repeated once your computer is set up. And there's a huge infrastructure in place (both technical and people) to ensure that many commits can land into the Firefox repository with the peace of mind that the code is peer reviewed, can be built and passes the tests, in multiple configurations and operating systems.
-
-So don't be afraid of committing errors: you will. This is what happens to us all the time.
+We all make lots of errors when we get started, so don't worry about that—there are safeguards in place to ensure that any commits that land in the Firefox repository are peer-reviewed, can be built, and pass the tests in multiple configurations and operating systems.
 
-It's a big system, and no one knows *absolutely everything*. What we do know is that we are not going to break Firefox. If we do something wrong, the system will let us know before we mess things up for real. Users won't ever notice, and you will learn a new thing.
+(Note: You can navigate these docs with the arrow keys.)
 
-[Let's get started](./getting-started/).
+[Let's get started!](./getting-started/)