Update the Windows instructions in the docs to use py launcher rather than Git bash

[Ramiro Morales]

Python installations on Windows now:

• Ship the PEP397 py launcher which reduces the need to either having to add python.exe directory to PATH or having to always specify its full path. It also can detect your Python's python.exe even when it's invoked from inside a virtualenv.
• Have a better "Execute manage.py or runtest.py by simply running them" story when compared to previous Python versions, thanks partially to the above mentioned launcher.

This would allow us to reduce special casing of Windows when describing command line interactions. In particular IMHO the suggestion to use the Git for Windows Bash shell can be dropped from the contributing tutorial as it doesn't actually make things easier.

[Ramiro Morales]

​PR

[Ramiro Morales]

A short screencast of how the new custom Sphinx directive works

[Tim Graham]

The ​djangoproject.com website doesn't use the sphinx theme, so separate changes are needed for this to work there.

A usability improvement would be for the operating system selector above the code blocks to toggle all blocks on the page rather than each individual block. It's annoying to follow the tutorial and have to click to change to Windows each time. For the website, I wonder if it would be worth trying to persist the user's choice in a cookie (and/or even try to pull it from the browser's user agent).

It could be useful to post about this effort on the DevelopersMailingList, just to make sure other Windows users are in agreement with these changes.

[Ramiro Morales]

Replying to Tim Graham:

The ​djangoproject.com website doesn't use the sphinx theme, so separate changes are needed for this to work there.

Done. See PR at ​https://github.com/django/djangoproject.com/pull/776

A usability improvement would be for the operating system selector above the code blocks to toggle all blocks on the page rather than each individual block. It's annoying to follow the tutorial and have to click to change to Windows each time.

Done, the PR has been updated. Also see ​http://imgur.com/3ce03UT

For the website, I wonder if it would be worth trying to persist the user's choice in a cookie (and/or even try to pull it from the browser's user agent).

Still nor done.

It could be useful to post about this effort on the DevelopersMailingList, just to make sure other Windows users are in agreement with these changes.

Done.. See ​https://groups.google.com/d/msg/django-developers/2INTyJOLMK0/zJ_QlsMfAQAJ

[Tim Graham <timograham@…>]

In 37c1784:

Fixed #28343 -- Add an OS chooser for docs command line examples.