Ned Deily added the comment:
Thank you for the patch, Yuly! You've made some good improvements to the current page. Because the current section is so old and out-of-sync with current practices (as you've noted in your changes) and with the nuances of Python on OS X, a more comprehensive restructuring is needed. I don't think that trying to refine the section interactively is going to be an efficient process but I will definitely use your suggested changes as a basis. I assume you have signed (or will be signing) the PSF contributor agreement. Thanks again! P.S. When submitting patches, don't forget to run patchcheck first (https://docs.python.org/devguide/patch.html#generation). It will detect and fix trailing whitespace in lines that would otherwise prevent a patch from being committed in the main cpython hg repo.