Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Appearance settings

Commit c3950af

Browse filesBrowse files
authored
Clarify 'time zone' in a Specific words section (#1352)
* Clarify 'time zone' in a Specific words section * Use a reference that matches the section title * mention markup use for timezone
1 parent 7bd3ae6 commit c3950af
Copy full SHA for c3950af

File tree

1 file changed

+14
-3
lines changed
Filter options

1 file changed

+14
-3
lines changed

‎documentation/style-guide.rst

Copy file name to clipboardExpand all lines: documentation/style-guide.rst
+14-3Lines changed: 14 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -54,10 +54,15 @@ starting it with a lowercase letter should be avoided.
5454
Many special names are used in the Python documentation, including the names of
5555
operating systems, programming languages, standards bodies, and the like. Most
5656
of these entities are not assigned any special markup, but the preferred
57-
spellings are given here to aid authors in maintaining the consistency of
58-
presentation in the Python documentation.
57+
spellings are given in :ref:`specific words` to aid authors in maintaining the
58+
consistency of presentation in the Python documentation.
5959

60-
Other terms and words deserve special mention as well; these conventions should
60+
.. _specific words:
61+
62+
Specific words
63+
==============
64+
65+
Some terms and words deserve special mention. These conventions should
6166
be used to ensure consistency throughout the documentation:
6267

6368
C API
@@ -79,6 +84,12 @@ reST
7984
used to produce Python documentation. When spelled out, it is
8085
always one word and both forms start with a lowercase 'r'.
8186

87+
time zone
88+
When referring to a Python term like a module, class, or argument spell it
89+
as one word with appropriate markup (for example, ``:mod:`timezone```).
90+
When talking about the real-world concept spell it as two words with no
91+
markup.
92+
8293
Unicode
8394
The name of a character coding system. This is always written
8495
capitalized.

0 commit comments

Comments
0 (0)
Morty Proxy This is a proxified and sanitized view of the page, visit original site.