This chunk of docs has bad info in both Python2 and Python3 docs:

4.1.3. Configuration

Python on OS X honors all standard Unix environment variables such as PYTHONPATH, but setting these variables for programs started from the Finder is non-standard as the Finder does not read your .profile or .cshrc at startup. You need to create a file ~/.MacOSX/environment.plist. See Apple’s Technical Document QA1067 for details.

If you search for QA1067, you are informed that the document is legacy and unsupported, with a suggestion for where to look now. That suggested link leads to a 404.

Searching the apple site, I find that at least some thoughtful developers think that configuring the environment isn't even possible, generally; and isn't considered good form even if so. Here:
https://forums.developer.apple.com/message/217422

I have no problem setting things for my terminal, as a longtime (unix) user, but for others, this section probably needs a complete examination with an eye toward making it current. quite possibly by reorganizing it.

Thanks for the reminder.  Yes, the whole "Using Python on a Macintosh" section is very much out-of-date and needs a complete rewrite.  It has been on my To Do list for a long time; I'll see what I can do to expedite it.

So, how do we wake this sleeping concern up?

Hi Gleen, the best way forward is to propose an improvement to the current documentation. It will get reviewed and merge if appropriate.

The source for this part is at https://github.com/python/cpython/blob/master/Doc/using/mac.rst and you can find the information needed to contribute in the Python Dev Guide: https://devguide.python.org/.

Thank you Remi

> On May 9, 2020, at 4:15 PM, Rémi Lapeyre <report@bugs.python.org> wrote:
> 
> 
> Rémi Lapeyre <remi.lapeyre@henki.fr> added the comment:
> 
> Hi Gleen, the best way forward is to propose an improvement to the current documentation. It will get reviewed and merge if appropriate.
> 
> The source for this part is at https://github.com/python/cpython/blob/master/Doc/using/mac.rst and you can find the information needed to contribute in the Python Dev Guide: https://devguide.python.org/.
> 
> ----------
> nosy: +remi.lapeyre
> 
> _______________________________________
> Python tracker <report@bugs.python.org>
> <https://bugs.python.org/issue32824>
> _______________________________________

Thank you, but how in the world does one know where to look or find that document at github.  I tried to search earlier and got hundreds of listings for python doc. 

Sent from my iPhone

> On May 9, 2020, at 16:36, Glenn Travis <pbfuddle@comcast.net> wrote:
> 
> Thank you Remi
> 
> 
>> On May 9, 2020, at 4:15 PM, Rémi Lapeyre <report@bugs.python.org> wrote:
>> 
>> 
>> Rémi Lapeyre <remi.lapeyre@henki.fr> added the comment:
>> 
>> Hi Gleen, the best way forward is to propose an improvement to the current documentation. It will get reviewed and merge if appropriate.
>> 
>> The source for this part is at https://github.com/python/cpython/blob/master/Doc/using/mac.rst and you can find the information needed to contribute in the Python Dev Guide: https://devguide.python.org/.
>> 
>> ----------
>> nosy: +remi.lapeyre
>> 
>> _______________________________________
>> Python tracker <report@bugs.python.org>
>> <https://bugs.python.org/issue32824>
>> _______________________________________
>

I see that this remains alive. I do have a newer question. Apple continues to say that they are going to drop all their included versions of python and I believe ruby in some future version of macOS. I thought that this would happen in Big Sur, but python versions 2.7.16 still remains with us, why, I don’t know.

> On Apr 28, 2021, at 3:21 PM, Irit Katriel <report@bugs.python.org> wrote:
> 
> 
> Change by Irit Katriel <iritkatriel@yahoo.com>:
> 
> 
> ----------
> versions: +Python 3.10, Python 3.11, Python 3.9 -Python 2.7, Python 3.6, Python 3.7, Python 3.8
> 
> _______________________________________
> Python tracker <report@bugs.python.org>
> <https://bugs.python.org/issue32824>
> _______________________________________

Here is a copy of the Apple Python call as of April 29, 2021.  To my way of thinking it seems that Apple is saying that someday they will indeed eliminate all the included “scripting” software from macOS and they further imply that one should install an. Up-to-date version of one’s particular chosen software. 

Last login: Thu Apr 29 08:22:47 on console
% python

WARNING: Python 2.7 is not recommended. 
This version is included in macOS for compatibility with legacy software. 
Future versions of macOS will not include Python 2.7. 
Instead, it is recommended that you transition to using 'python3' from within Terminal.

Python 2.7.16 (default, Feb 28 2021, 12:34:25) 
[GCC Apple LLVM 12.0.5 (clang-1205.0.19.59.6) [+internal-os, ptrauth-isa=deploy on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>> exit()
% exit
Saving session...
...copying shared history...
...saving history...truncating history files...
...completed.

[Process completed]

> On Apr 28, 2021, at 4:25 PM, Glenn Travis <report@bugs.python.org> wrote:
> 
> 
> Glenn Travis <pbfuddle@comcast.net> added the comment:
> 
> I see that this remains alive. I do have a newer question. Apple continues to say that they are going to drop all their included versions of python and I believe ruby in some future version of macOS. I thought that this would happen in Big Sur, but python versions 2.7.16 still remains with us, why, I don’t know.
> 
>> On Apr 28, 2021, at 3:21 PM, Irit Katriel <report@bugs.python.org> wrote:
>> 
>> 
>> Change by Irit Katriel <iritkatriel@yahoo.com>:
>> 
>> 
>> ----------
>> versions: +Python 3.10, Python 3.11, Python 3.9 -Python 2.7, Python 3.6, Python 3.7, Python 3.8
>> 
>> _______________________________________
>> Python tracker <report@bugs.python.org>
>> <https://bugs.python.org/issue32824>
>> _______________________________________
> 
> ----------
> 
> _______________________________________
> Python tracker <report@bugs.python.org>
> <https://bugs.python.org/issue32824>
> _______________________________________

assignee: docs@python -> ned.deily
versions: + Python 2.7, Python 3.6, Python 3.7, Python 3.8
nosy: + ned.deily

messages: + msg312028
stage: needs patch