diff -r d1aa8a9eba44 Doc/tutorial/classes.rst
--- a/Doc/tutorial/classes.rst	Wed May 01 14:13:05 2013 +0300
+++ b/Doc/tutorial/classes.rst	Sun May 05 09:59:56 2013 -0400
@@ -344,12 +344,15 @@
 
 .. These should perhaps be placed more carefully...
 
-Data attributes override method attributes with the same name; to avoid
-accidental name conflicts, which may cause hard-to-find bugs in large programs,
-it is wise to use some kind of convention that minimizes the chance of
-conflicts.  Possible conventions include capitalizing method names, prefixing
-data attribute names with a small unique string (perhaps just an underscore), or
-using verbs for methods and nouns for data attributes.
+Instance attributes hide class attributes. Instance data names are often
+intended to override class data names. But instance data names masking
+methods names is likely a mistake. This can be avoided by using verbs for
+method names and nouns for data names; to avoid accidental name conflicts,
+which may cause hard-to-find bugs in large programs, it is wise to use some
+kind of convention that minimizes the chance of conflicts.  Possible
+conventions include capitalizing method names, prefixing data attribute names
+with a small unique string (perhaps just an underscore), or using verbs for
+methods and nouns for data attributes.
 
 Data attributes may be referenced by methods as well as by ordinary users
 ("clients") of an object.  In other words, classes are not usable to implement
diff -r d1aa8a9eba44 Misc/NEWS
--- a/Misc/NEWS	Wed May 01 14:13:05 2013 +0300
+++ b/Misc/NEWS	Sun May 05 09:59:56 2013 -0400
@@ -111,6 +111,8 @@
 Documentation
 -------------
 
+- Issue #12634: Modify Random Remarks in class documentation.
+
 - Issue #15940: Specify effect of locale on time functions.
 
 - Issue #6696: add documentation for the Profile objects, and improve