[docs] [issue17057] Data model documentation grammar

Hobs report at bugs.python.org
Mon Jan 28 01:24:17 CET 2013


New submission from Hobs:

New-style and old-style class expalanation in the datamodel section has minor grammatical errors and one minor ambiguity that could be improved.

http://docs.python.org/2/reference/datamodel.html#new-style-and-classic-classes

* "independently of" should always be "indepenent of"
* single hyphens (-) should be double-hyphens (--) for an m-dash
* "flavour" should be "flavor" (used 100x more often in docs.python)
* "only the symantics of..." is ambiguous. can't tell if 'only' modifies 'symantics' or 'new-style classes'?

----------
assignee: docs at python
components: Documentation
files: datamodel-reference-docs.patch
keywords: patch
messages: 180812
nosy: Hobson.Lane, docs at python
priority: normal
severity: normal
status: open
title: Data model documentation grammar
type: enhancement
versions: Python 2.7
Added file: http://bugs.python.org/file28876/datamodel-reference-docs.patch

_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue17057>
_______________________________________


More information about the docs mailing list