summaryrefslogtreecommitdiff
path: root/docs/internals
diff options
context:
space:
mode:
Diffstat (limited to 'docs/internals')
-rw-r--r--docs/internals/contributing/writing-documentation.txt4
1 files changed, 4 insertions, 0 deletions
diff --git a/docs/internals/contributing/writing-documentation.txt b/docs/internals/contributing/writing-documentation.txt
index 5036f30fe0..91b81e4673 100644
--- a/docs/internals/contributing/writing-documentation.txt
+++ b/docs/internals/contributing/writing-documentation.txt
@@ -239,6 +239,10 @@ documentation:
section if possible. For example, use ``:rfc:`2324#section-2.3.2``` or
``:rfc:`Custom link text <2324#section-2.3.2>```.
+* Use :rst:role:`:pep:<pep>` to reference a Python Enhancement Proposal (PEP)
+ and try to link to the relevant section if possible. For example, use
+ ``:pep:`20#easter-egg``` or ``:pep:`Easter Egg <20#easter-egg>```.
+
Django-specific markup
======================