This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

Author ezio.melotti
Recipients docs@python, eric.araujo, ezio.melotti, fdrake, flox, loewis, pitrou, scoder
Date 2011-12-16.11:09:20
SpamBayes Score 9.36182e-08
Marked as misclassified No
Message-id <1324033761.17.0.903654175636.issue11379@psf.upfronthosting.co.za>
In-reply-to
Content
> 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.
History
Date User Action Args
2011-12-16 11:09:21ezio.melottisetrecipients: + ezio.melotti, loewis, fdrake, pitrou, scoder, eric.araujo, flox, docs@python
2011-12-16 11:09:21ezio.melottisetmessageid: <1324033761.17.0.903654175636.issue11379@psf.upfronthosting.co.za>
2011-12-16 11:09:20ezio.melottilinkissue11379 messages
2011-12-16 11:09:20ezio.melotticreate