Opened 7 years ago
Closed 7 years ago
#28343 closed Cleanup/optimization (fixed)
Update the Windows instructions in the docs to use py launcher rather than Git bash
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 )
Python installations on Windows now:
- Ship the PEP397
py
launcher which reduces the need to either having to addpython.exe
directory to PATH or having to always specify its full path. It also can detect your Python'spython.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 (6)
comment:1 by , 7 years ago
Has patch: | set |
---|
comment:2 by , 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 |
follow-up: 5 comment:4 by , 7 years ago
Patch needs improvement: | set |
---|
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.
comment:5 by , 7 years ago
Patch needs improvement: | unset |
---|
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
PR