[issue10389] Document rules for use of case in section titles

[Alexander Belopolsky]

Alexander Belopolsky  added the comment:

Committed in revision 86417.

--
status: open -> closed

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10389] Document rules for use of case in section titles

[Éric Araujo]

Éric Araujo  added the comment:

Looks good.  I wouldn’t say reST is WYSIWYG, since it’s transformed, contrary 
to word processors where you make text bold to get it bold.

(If you’re looking for other things to fix in that file, look at the entry for 
Unicode ;)

--

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10389] Document rules for use of case in section titles

[Alexander Belopolsky]

Alexander Belopolsky  added the comment:

The new patch, issue10389.diff, addresses Éric's comments and adds an entry for 
"reST".

--
Added file: http://bugs.python.org/file19571/issue10389.diff

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10389] Document rules for use of case in section titles

[Éric Araujo]

Éric Araujo  added the comment:

+1 about the patch, if you add an example: “sentence case” may not be obvious 
for everyone.  If it’s “modulename — Module description”, I agree.

Also, s/white space/whitespace/.

--
nosy: +d...@python, eric.araujo

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

[issue10389] Document rules for use of case in section titles

[Alexander Belopolsky]

New submission from Alexander Belopolsky :

Following a brief and consensual discussion on d...@python and #python-dev, I 
am proposing attached patch for the Python documentation style guide.

--
assignee: belopolsky
components: Documentation
files: style-guide.diff
keywords: patch
messages: 120955
nosy: belopolsky
priority: normal
severity: normal
stage: patch review
status: open
title: Document rules for use of case in section titles
versions: Python 3.2
Added file: http://bugs.python.org/file19570/style-guide.diff

___
Python tracker 

___
___
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com