summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--docs/internals/security.txt33
1 files changed, 33 insertions, 0 deletions
diff --git a/docs/internals/security.txt b/docs/internals/security.txt
index 32705584a4..3c7271e0b8 100644
--- a/docs/internals/security.txt
+++ b/docs/internals/security.txt
@@ -43,6 +43,39 @@ the industry-standard 90 days. Confirmed vulnerabilities with a
.. _our public Trac instance: https://code.djangoproject.com/query
+.. _respecting-maintainer-time:
+
+Respecting maintainer time
+--------------------------
+
+Django's security team are volunteers. Please be mindful and respectful of
+their time when submitting reports. Your initial report should give the team
+enough to make a triage decision, no more. It should include:
+
+* A brief description of the issue and where in Django it occurs.
+
+* A minimal, working proof of concept (code snippet or reproduction steps).
+
+* The versions of Django and Python you tested against.
+
+* Optionally, a minimal patch with the mitigation for the issue.
+
+Please do not include severity scores (CVSS or otherwise), lengthy background
+sections, multiple headers, or a determination of whether the issue constitutes
+a vulnerability. The security team will make those assessments. Extensive
+upfront analysis makes triage slower, not faster. If the team confirms the
+issue is a valid vulnerability, they will follow up and welcome further detail
+at that stage.
+
+If you have identified multiple potential issues, please wait for a triage
+result on your initial report before submitting further ones. Exceptions can be
+made for issues that are clearly and directly related to an already reported
+finding. Feedback on an initial report is often relevant to subsequent ones,
+and taking the time to read and incorporate it leads to better reports overall.
+
+The security team is not able to process large volumes of reports submitted in
+a short period of time, and reports submitted in bulk may be put on hold.
+
Reporting guidelines
--------------------