http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... File Doc/library/xml.etree.elementtree.rst (right): http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:114: input. Processing instructions and comments can nevertheless be I think this could be made clearer. Something like "trees built using this module's API rather than parsing from XML test can have comments and processing instructions in them, and are included...." http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:396: Note that the element tree XML parser skips over comments in the Replace "the element tree XML parser" with a properly ReST-linked "ElementTree", as done elsewhere in the document. http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:399: into to the tree using :meth:`~Element.insert`, I don't think this listing is necessary - there are many ways to create new Element nodes... http://bugs.python.org/review/20375/diff/11483/Doc/library/xml.etree.element... Doc/library/xml.etree.elementtree.rst:483: instructions in the input instead of creating objects for them. An same comments here as for the previous block. http://bugs.python.org/review/20375/