[issue12634] Random Remarks in class documentation

Raymond Hettinger added the comment: New changeset f6a7f5bc50f4267cfb7fe0c4ea16d5359c009cbd by Raymond Hettinger (Miss Islington (bot)) in branch '3.8': bpo-12634: Clarify an awkward section of the tutorial (GH-15406) (GH-15409) https://github.com/python/cpython/commit/f6a7f5bc50f4267cfb7fe0c

[issue12634] Random Remarks in class documentation

Change by Raymond Hettinger : -- resolution: -> fixed stage: patch review -> resolved status: open -> closed ___ Python tracker ___ ___

[issue12634] Random Remarks in class documentation

Raymond Hettinger added the comment: New changeset 483ae0cf1dcf46f8b71c4bf32419dd138e908553 by Raymond Hettinger in branch 'master': bpo-12634: Clarify an awkward section of the tutorial (GH-15406) https://github.com/python/cpython/commit/483ae0cf1dcf46f8b71c4bf32419dd138e908553 --

[issue12634] Random Remarks in class documentation

Change by miss-islington : -- pull_requests: +15114 pull_request: https://github.com/python/cpython/pull/15409 ___ Python tracker ___ __

[issue12634] Random Remarks in class documentation

Change by Raymond Hettinger : -- versions: +Python 3.8, Python 3.9 -Python 2.7, Python 3.2, Python 3.3, Python 3.4 ___ Python tracker ___ _

[issue12634] Random Remarks in class documentation

Change by Raymond Hettinger : -- pull_requests: +15111 stage: needs patch -> patch review pull_request: https://github.com/python/cpython/pull/15406 ___ Python tracker ___

[issue12634] Random Remarks in class documentation

Changes by Yogesh Chaudhari : -- hgrepos: -188 ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.pyt

[issue12634] Random Remarks in class documentation

Yogesh Chaudhari added the comment: Based on Teery's comments, this patch makes the changes to the random remarks section of the class documentation -- keywords: +patch nosy: +Yogesh.Chaudhari Added file: http://bugs.python.org/file30134/issue12634.patch ___

[issue12634] Random Remarks in class documentation

Yogesh Chaudhari added the comment: Similar changes for 2.7 branch -- hgrepos: +188 Added file: http://bugs.python.org/file30135/issue12634-27.patch ___ Python tracker ___ __

[issue12634] Random Remarks in class documentation

Yongzhi Pan added the comment: It may be worth to noting that when creating property attribute using the property decorator, we may tend to name the method using nouns, like here: http://docs.python.org/2/library/functions.html#property This is when I once overided data attribute with method.

[issue12634] Random Remarks in class documentation

Changes by Yongzhi Pan : -- nosy: +fossilet ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python.

[issue12634] Random Remarks in class documentation

Changes by Chris Rebert : -- nosy: +cvrebert ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail.python

[issue12634] Random Remarks in class documentation

Ezio Melotti added the comment: See also #16048. -- ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe: http://mail

[issue12634] Random Remarks in class documentation

Éric Araujo added the comment: +1 to something like Terry’s proposal. -- keywords: +easy stage: -> needs patch type: enhancement -> versions: +Python 3.4 ___ Python tracker ___

[issue12634] Random Remarks in class documentation

Terry J. Reedy added the comment: That sentence is wrong to imply that there is anything special about data versus method attributes with respect to overriding -- or that attributes are special when it comes to names in a single namespace. What I think the paragraph should say, if not just de

[issue12634] Random Remarks in class documentation

Éric Araujo added the comment: I have the same reading as Ezio, and the same opinion that it’s unclear and unhelpful. +1 to saying that there is only one namespace for data attributes and methods. -- ___ Python tracker

[issue12634] Random Remarks in class documentation

Ezio Melotti added the comment: Indeed that paragraph is not really clear. I had to read it till the end ("verbs for methods and nouns for data attributes") to figure out what it was talking about. Even then it's still not clear what it's trying to say. I *think* it means that if you have a

[issue12634] Random Remarks in class documentation

Raymond Hettinger added the comment: The proposed rewrite doesn't make any sense to me. Also "set through" is an reads awkwardly. -- assignee: docs@python -> rhettinger nosy: +rhettinger ___ Python tracker _

[issue12634] Random Remarks in class documentation

New submission from Ashutosh Swain : URL: http://docs.python.org/tutorial/classes.html section: 9.4 Random Remarks The first sentense is bit confusing: "Data attributes override method attributes with the same name" Is it possible to change the sentense something like this: "Data attributes se