Most changes to Python require a NEWS entry. Add one using the blurb_it web app or the blurb command-line tool.

If this change has little impact on Python users, wait for a maintainer to apply the skip news label instead.

All commit authors signed the Contributor License Agreement.

A Python core developer has requested some changes be made to your pull request before we can consider merging it. If you could please address their requests along with any other requests in other reviews from core developers that would be appreciated.

Once you have made the requested changes, please leave a comment on this pull request containing the phrase I have made the requested changes; please review again. I will then notify any core developers who have left a review that you're ready for them to take another look at this pull request.

It seems you ran a linter, causing a massive diff. Please revert the unrelated changes.

It seems you ran a linter, causing a massive diff. Please revert the unrelated changes.

I have made the requested changes; please review again

Thanks for making the requested changes!

@StanFromIreland: please review the changes made to this pull request.

@StanFromIreland please review the changes made to this pull request.

Sorry I'm not an expert in these modules, I requested Serhiy.

Don't rush. First we need to decide which behavior is more desirable.

Don't rush. First we need to decide which behavior is more desirable.

I’ll hold off on working on a fix until the expected behavior is clearer. Once confirmed about the desired behavior please share that to me as well

First we need to decide which behavior is more desirable.

Comments and PIs should not contribute to the text returned by .itertext(). Comments are literally meant to add notes to the document that do not contribute to the document's processed content. It makes no sense to bother users with it. If they really want them to be included, it's easy to write an iterator that does include them, easier than excluding them, really. The built-in tool behaviour should follow the normal case of excluding them.

It was decided to move in opposite direction.