Describing making Python 3 the default `python` under Homebrew

So, about this section in the OS X installation guides:

That opt/python/libexec behavior is not actually about 10.12 Sierra vs. newer versions of macOS. Homebrew does not make the unqualified python command be Python 3 on any version of macOS. If this behavior was different in the past, that was due to a different Homebrew version, not a different macOS version. (Homebrew's policy is to not shadow system-provided components in a way that might break things.)

Maybe this section should be updated to something like:

Once you've installed Homebrew, insert the Homebrew directory at the top
of your :envvar:`PATH` environment variable if you are running 10.12 Sierra or older.
You can do this by adding the following line at the bottom of your :file:`~/.profile` file:

.. code-block:: console

    export PATH="/usr/local/bin:/usr/local/sbin:$PATH"

Now, we can install Python 3:

.. code-block:: console

    $ brew install python

Then, to make your default `python` command point to Python 3:

.. code-block:: console

    export PATH="/usr/local/opt/python/libexec/bin:$PATH"

And the section in the Python 2 installation about doing PATH="/usr/local/opt/python@2/libexec/bin:$PATH" is no longer necessary: the Homebrew python@2 formula now provides a python command that is in /usr/local/bin by default.

Might also want to provide a link to Homebrew's Homebrew and Python page, which goes in to more detail.

Recherchez dans les guides d’installation de OS X la section sur Homebrew et Python 3 présentée dans l’issue, puis consultez la page de Homebrew consacrée à Homebrew et Python pour connaître le comportement actuel. Mettez à jour les instructions concernant Python 3 et Python 2 afin qu’elles reflètent la gestion de PATH et renvoient vers la documentation de Homebrew ; le travail est considéré comme terminé lorsque la distinction entre les versions de macOS et le comportement par défaut de la commande python sont exacts.