Author eli.bendersky
Recipients docs@python, eli.bendersky, hheimbuerger, serhiy.storchaka, techtonik
Date 2013-02-26.13:32:42
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1361885563.48.0.442263734443.issue11367@psf.upfronthosting.co.za>
In-reply-to
Content
Henrik. Yes, I think the change in 3.3 was intentional in order to avoid duplication that can be a source of errors. If ET.find() does exactly what ET.getroot().find() does, it suffices to mention it with a link. Since Element docs come first and arguably Element's methods are much more widely used, I think it's a good tradeoff. Any duplication is yet another place to remember fixing when problems in the documentation are discovered (like the original problem leading to this issue).

So for consistency you can make all methods point to Element's methods (just backport 3.3's version, but please verify that the code behavior is indeed as documented in earlier versions).
History
Date User Action Args
2013-02-26 13:32:43eli.benderskysetrecipients: + eli.bendersky, techtonik, docs@python, serhiy.storchaka, hheimbuerger
2013-02-26 13:32:43eli.benderskysetmessageid: <1361885563.48.0.442263734443.issue11367@psf.upfronthosting.co.za>
2013-02-26 13:32:43eli.benderskylinkissue11367 messages
2013-02-26 13:32:42eli.benderskycreate