Opened 56 minutes ago

Last modified 44 minutes ago

#37370 new Cleanup/optimization

Reorganize Django's security policy page

Reported by: Sarah Boyce Owned by:
Component: Documentation Version: 6.1
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

Django's security policy has grown organically over time. The page would probably benefit being restructured to make it easier to navigate/read/digest.

The current structure is roughly:

Django's security policy
├── Reporting security issues
│   ├── Respecting maintainer time
│   └── Reporting guidelines
├── How does Django evaluate a report
├── Supported versions
├── Security issue severity levels
├── How Django discloses security issues
├── Who receives advance notification
└── Requesting notifications
  • Some of the reporting guidelines describe what a reporter should include, while others describe the scope of issues Django will consider.
  • Supported versions and severity are also closely related to the assessment process but currently sit separately.
  • There are two notification sections which could be grouped

One possible reorganization would be:

Django's security policy
├── Reporting security vulnerabilities
│   ├── How to report
│   ├── What to include
│   ├── Scope and reporting requirements
│   ├── Respecting maintainer time
│   └── AI-assisted reports
├── Assessing security vulnerabilities
│   ├── How Django evaluates a report
│   ├── Supported versions
│   ├── Security severity levels
│   └── Issues outside Django
├── Disclosing security vulnerabilities
│   ├── Coordinated disclosure
│   ├── Advance disclosure
│   ├── Public disclosure
│   └── Exceptional circumstances
└── Security notifications
    ├── Who receives advance notification
    ├── Who does not receive advance notification
    └── Requesting notifications

I am open to other grouping/structure suggestions and would welcome us looking at other open source security policies to guide us on what would be best here.

Change History (1)

comment:1 by Natalia Bidart, 44 minutes ago

Triage Stage: UnreviewedAccepted

Accepting following on agreement from the latest security meeting.

Note: See TracTickets for help on using tickets.
Back to Top