class Bicycle:

   __data_dictionary__ = dict(
      category = 'Primary use: road, cross-over, or hybrid',
      model = 'Unique six digit vendor-supplied code',
      size = 'Rider size: child, small, medium, large, extra-large',
      price = 'Manufacturer suggested retail price', 
   )

>>> help(Bicycle)
class Bicycle(builtins.object)
 |  Data fields defined here:
 |
 |  category
 |      Primary use: road, cross-over, or hybrid
 |
 |  model
 |      Unique six digit vendor-supplied code
 |
 |  size
 |      Rider size: child, small, medium, large, extra-large
 |
 |  price
 |      Manufacturer suggested retail price
 |
 |  ----------------------------------------------------------------------
 |
 |  Data descriptors defined here:
 |  
 |  __dict__
 |      dictionary for instance variables (if defined)
 |  
 |  __weakref__
 |      list of weak references to the object (if defined)
 |  
 |  ----------------------------------------------------------------------
 |  Data and other attributes defined here:
 |  
 |  __data_dictionary__ = {'category': 'Primary use: road, cross-over, or .

Something like this would be especially helpful for classes using __slots__. 

The member objects show-up in help(), but there is no way to attach an explanation like we can with property objects.

So there is a slots only alternative that would only involve modifying help() and nothing else:

   class Bicycle:

       __slots__ = dict(
           category = 'Primary use: road, cross-over, or hybrid',
           model = 'Unique six digit vendor-supplied code',
           size = 'Rider size: child, small, medium, large, extra-large',
           price = 'Manufacturer suggested retail price', 
       )

Moving to a fresh issue.

messages: + msg338123
stage: resolved