added more detail to quality reports

stacyspiva · stacyspiva · commit 09dec94fd7c7 · 2020-04-16T14:44:47.000-07:00
diff --git a/docs/hackers/quality-reports.md b/docs/hackers/quality-reports.md
@@ -4,11 +4,17 @@ path: "/hackers/quality-reports.html"
 id: "hackers/quality-reports"
 ---
 
-You notify programs of vulnerabilities by submitting reports to the program's inbox. Not all great vulnerability reports look the same, but many share these common features:
+By submitting reports to the program's inbox, you're able to notify programs of vulnerabilities . Not all great vulnerability reports look the same, but many share these common features:
 * Detailed descriptions of your discovery with clear, concise, reproducible steps or a working proof-of-concept (POC). If you do not explain the vulnerability in detail, there may be significant delays in the process, which is undesirable for everyone.
 * Screenshots and/or videos can sometimes assist security teams in reproducing your issue. Most teams prefer written reproduction steps, but screenshots and videos can be used to augment your report and make it easier for security teams to quickly understand the issue you're reporting.
 * The impact of the vulnerability; if this bug were exploited, what could happen? Security teams need to file bugs internally and get resources to fix these issues. Describing why the issue is important can assist in quickly understanding the impact of the issue and help prioritize response and remediation.
 
+It’s best to be comprehensive, yet concise as security teams need to have all the details required to verify and validate your report. We recommend you provide enough information to
+* Outline the bug
+* Reproduce the bug
+* Assess the coverage the bug applies to
+* Provide additional related logs or information
+
 ### Examples
 Here are some examples of publicly disclosed examples of good reports:
 * [Twitter disclosed on HackerOne: URGENT - Subdomain Takeover](https://hackerone.com/reports/32825)
