Sounds very good to me. One small thing: in the first para of "Audience", there's a "talk down them" which looks funny to me in this word order. One question: I could imagine wording like "this is rarely needed" instead of "this is experts only" -- would you say it will be effective in making people think if they really want to do that?
> there's a "talk down them" which looks funny to me in this word order. It was missing a word. Should be "talk down to them". Thanks for spotting this -- I fix it in the commit. > One question: I could imagine wording like > "this is rarely needed" instead of "this is experts only" > -- would you say it will be effective in making people > think if they really want to do that? Something along these lines would be a step in the right direction (though "rarely needed" is problematic if happens to match the readers need at the moment). At this point, I would be happy just to get rid of the danger-experts-only remarks. Just about any substitute would be better.
This issue has been migrated to GitHub: https://github.com/python/cpython/issues/56256 
