[docs] [issue11379] Remove "lightweight" from minidom description
Ezio Melotti
report at bugs.python.org
Fri Dec 16 12:09:21 CET 2011
Ezio Melotti <ezio.melotti at gmail.com> added the comment:
> xml.dom.minidom is a [-XXX: light-weight] implementation of the Document Object Model interface.
This is ok.
> It is intended to be simpler than the full DOM and also
> [+XXX: provide a] significantly smaller [+XXX: API].
Doesn't "simpler" here refer to the API already?
Another option is to add somewhere a section like:
"If you have to work with XML, ElementTree is usually the best choice, because it has a simple API and it's efficient [or whatever]. xml.dom.minidom provides a subset of the W3C-DOM API, and xml.sax a SAX interface.", possibly expanding a bit on the differences and showing a minimal example with the 3 different implementations, and then link to it from the other modules' pages.
----------
_______________________________________
Python tracker <report at bugs.python.org>
<http://bugs.python.org/issue11379>
_______________________________________
More information about the docs
mailing list