included how to unlock a report

stacyspiva · stacyspiva · commit a4e0bf7b1624 · 2019-01-16T19:47:00.000-08:00
diff --git a/contributing-guidelines.md b/contributing-guidelines.md
@@ -1,14 +1,6 @@
-# Style Guide 
-### Changelog
-When adding a new entry to the changelog, make sure you format the file such that the first several lines of the markdown file are:
+# Style Guide
 
-`---`<br>
-`title: "November 2016"`<br>
-`path: "/changelog/2016/november"`<br>
-`date: "2016-11"`<br>
-`---`
-
-### New Articles
+### Adding New Articles
 You can add new articles to either the Hacker Book or the Program Book.
 
 #### Hacker Book
@@ -29,10 +21,51 @@ When adding a new article to the program book, make sure you format the file suc
 `id: "programs/title-of-the-article"`<br>
 `---`
 
-### Formatting
+#### Changelog Entry For a New Month
+You can also add a changelog entry for a new month that isn't listed on the changelog yet. To add a changelog entry for a new month, make sure you format the file such that the firs several lines of the markdown file are:
+
+`---`<br>
+`title: "Month Year"`<br>
+`path: "/changelog/[year]/[month]"`<br>
+`date: "year-month number"`<br>
+`---`
+
+Example:
+<br>`---`<br>
+`title: "November 2016"`<br>
+`path: "/changelog/2016/November"`<br>
+`date: "2016-11"`<br>
+`---`
+
+### Github Formatting
 How do I... | Answer
 ----------- | -------
 Add a link to a page within the docs site of the same book | `[Start H1 Response](start-h1-response.html)` or `[Start H1 Bounty](start-h1-bounty.html)`.
 Add a link to a page within the docs site to an article in another book | `[Start H1 Bounty](/programs/start-h1-bounty.html)`
 Add an image | `![image name](./images/signal-impact-2.png)`
-Referencing the HackerOne blog link | Use `https://hackerone.com/blog` not www.hackerone.com/bog
+Referencing the HackerOne blog link | Use `https://hackerone.com/blog` not www.hackerone.com/blog
+
+### Active Voice
+We use active voice at HackerOne as active voice is more personal and engaging vs. passive voice. In active voice, the subject does or acts upon the verb, while in passive voice, the subject is being acted upon. 
+
+Active Voice (Yes, please use this!) | Passive Voice (Steer away from this)
+------------------------------------ | -------------------------------------
+Click the link to search | The link should be clicked when you're ready to search for an article.
+The hacker reported the vulnerability. | The vulnerability was reported by the hacker.
+The security team triaged the report. | The report was triaged by the security team.
+
+### Contractions
+In order to convey a personal and less formal voice, it's best to use contractions instead of the formal non-contractions.
+
+Contraction - (Yes, please use this!) | Non-Contracted Phrases (Steer away from this)
+------------------------------------- | -----------------------------------
+can't | cannot
+don't | do no
+won't | will not
+it's | it is
+they're | they are
+we've | we have
+you're | you are
+
+### Spelling
+There are some words that can be used either way. In order to keep consistency, we need to agree on which ambiguous word we'll be using.
diff --git a/docs/programs/images/lock-report-3.png b/docs/programs/images/lock-report-3.png
diff --git a/docs/programs/response-target-metrics.md b/docs/programs/response-target-metrics.md
@@ -8,7 +8,7 @@ HackerOne tracks and enables you to define targets for these 4 response efficien
 
 Response Efficiency Metric | Details
 ---- | -------
-Time to first response | The elapsed time from when the report is submitted to the first public activity on a report. The first public activity includes adding a public comment, changing the report state, or changing the report severity.
+Time to first response | The elapsed time from when the report is submitted, to the first public activity on a report. The first public activity includes adding a public comment, changing the report state, or changing the report severity.
 Time to triage | The elapsed time from when a report is submitted to when a report is changed to a triaged state. A report can skip the triaged state and move directly to a closed state (e.g. resolved).
 Time to bounty | *(Bounty programs only)* The elapsed time from when a report is triaged to when a bounty is paid. Only reports that are eligible for a bounty will be tracked as part of this metric. The time to bounty timer will run until the report is either marked as ineligible or closed as a state where it’s not normal to award a bounty (e.g. spam).<br><br><i>Awarding swag in lieu of a bounty won't stop the timer. If you only award a report with swag, you must mark the report as ineligible for bounty to stop the timer</i>.
 Time to resolution | The elapsed time from when a report is submitted to when a report is closed. These five closed report states will stop the timer: <i>resolved, informative, not applicable, duplicate,</i> and <i>spam</i>. For programs using [human-augmented signal](human-augmented-signal.html), the resolution timer starts when the report has been approved by HackerOne Security Analysts and escalated to the customer's inbox.  
