Remove ":py" domain from roles
In the documentation source files, there's some confusion about roles like :py:class:`email.message.EmailMessage`
. In this case, py
indicates the Python language domain (which means any code written in Python, not Python built-ins in particular).
Since the Python domain is the default in Sphinx, you can omit the :py
prefix when referring to Python objects, for example, using :class:
instead of :py:class:
.
Including :py
ensures clarity and avoids ambiguity if other domains are also in use., but since the Django documentation doesn't use other domains (C++, JavaScript, etc.), I see no reason to include the prefix.
Change History
(8)
Owner: |
set to JaeHyuckSa
|
Status: |
new → assigned
|
Triage Stage: |
Unreviewed → Accepted
|
Patch needs improvement: |
set
|
Patch needs improvement: |
unset
|
Triage Stage: |
Accepted → Ready for checkin
|
Resolution: |
→ fixed
|
Status: |
assigned → closed
|
In 3c0c5435: