Eli Bendersky <eli...@gmail.com> added the comment:

If you want to collect additional feedback, you may want to add some other 
people to the Nosy list :-) Alternatively, since it's a small doc change you 
can just commit it and it can be fixed later if someone strongly objects.

>>>
This:

  The :class:`Element` type is a flexible container object, designed to store
  hierarchical data structures in memory.  The type can be described as a cross
  between a list and a dictionary.

?  Yeah, it’s not quite good.
>>>

Yes. You read the first section of a module's doc and you have *no idea* what 
the module is and how to use it. I plant to work on this for 3.3 in the context 
of issue 14006.

----------

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue14009>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
http://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to