Opened 7 years ago

Last modified 7 years ago

#28343 closed Cleanup/optimization

Update the Windows instructions in the docs to use py launcher rather than Git bash — at Version 2

Reported by: Ramiro Morales Owned by: Ramiro Morales
Component: Documentation Version: dev
Severity: Normal Keywords:
Cc: Triage Stage: Accepted
Has patch: yes Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description (last modified by Tim Graham)

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.

Change History (2)

comment:1 by Ramiro Morales, 7 years ago

Has patch: set

​PR

comment:2 by Tim Graham, 7 years ago

Description: modified (diff)
Summary: Documentation for Windows users can be simpler now that we only support Python >= 3.5 → Update the Windows instructions in the docs to use py launcher rather than Git bash
Triage Stage: Unreviewed → Accepted
Note: See TracTickets for help on using tickets.
Back to Top