﻿id	summary	reporter	owner	description	type	status	component	version	severity	resolution	keywords	cc	stage	has_patch	needs_docs	needs_tests	needs_better_patch	easy	ui_ux
35511	Documentation uses the py binary in Windows, which may not always be available	Alex	Alex	"In places like the tutorial, the windows version of the command always uses `py` like, `py -m django --version`.

The `py` binary is available only if python is installed via the python.org installer. However, if you install python via the Microsoft Store, the `py`binary is not available. 
> When you install Python from the Microsoft Store, the py command is not included. For Linux, macOS, WSL and the Microsoft Store version of Python, you should use the python3 (or python3.7) command.
https://learn.microsoft.com/en-us/windows/python/faqs#what-is-py-exe-

The python.org installer adds `py` by default, however, it only adds `python` if the option ""Add python.exe to PATH"" is selected in the first step of the installer.
Without the option, typing `python` or `python3` will launch the [https://apps.microsoft.com/detail/9pjpw5ldxlz5?hl=en-us&gl=US Microsoft Store] 

I would recommend that in the [https://docs.djangoproject.com/en/5.0/intro/install/#install-python install section] have specific instructions for Windows to use the python.org installer, not the Microsoft Store one. Also explain that the store one, doesn't have `py`."	Cleanup/optimization	closed	Documentation	dev	Normal	fixed	windows	Alex Baptiste Mispelon	Ready for checkin	1	0	0	0	0	0
