Ezio Melotti <ezio.melotti@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@bugs.python.org> <http://bugs.python.org/issue11379> _______________________________________