diff options
author | 2022-11-12 18:32:22 -0800 | |
---|---|---|
committer | 2022-11-12 18:32:22 -0800 | |
commit | d065f2e71b5741e0a65ce33a1093685f9c6d9501 (patch) | |
tree | 0ee8f510d74b17ce06426c4878da15f2abe02413 | |
parent | Note about admin needed, and added subheading to Path guide. (diff) |
Added some of wookies Windows guide review suggestions
3 files changed, 12 insertions, 6 deletions
diff --git a/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md b/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md index 35041dd8..6ab3e3c5 100644 --- a/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md +++ b/pydis_site/apps/content/resources/guides/python-guides/windows/common-issues.md @@ -135,7 +135,7 @@ common causes for this are: To check if this is the case, type `pip -V`. If the path output includes something like `PythonSoftwareFoundation.Python.3.10_3.10.2288.0_x64__qbz5n2kfra8p0`, you are using Python from the Microsoft Store. To fix this you will either have to use the full path to the scripts you want to use, or [uninstall the - Microsoft Store Python](/static/images/content/python-on-windows/ms_store_uninstall.png) and [install Python + Microsoft Store Python](../miscrosoft-store/#uninstalling) and [install Python properly](../installing-and-using-python) with a [python.org installer](https://www.python.org/downloads). - You manually modified your PATH Environment Variable incorrectly diff --git a/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md b/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md index f2ad0a2f..4bbaf4a3 100644 --- a/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md +++ b/pydis_site/apps/content/resources/guides/python-guides/windows/installing-and-using-python.md @@ -6,7 +6,7 @@ toc: 3 --- Our recommended way of installing Python on a Windows operating system is using the full installer from the official -[python.org Downloads page](https://www.python.org/downloads/) (hit the big yellow button) using the default options, +[python.org Downloads page](https://www.python.org/downloads/) (from the big yellow button) using the default options, except making sure to check the "Add python.exe to PATH" checkbox. Getting Python from the [Microsoft Store](https://apps.microsoft.com/store/search/python) is _not_ recommended as [it can cause various issues](../microsoft-store). @@ -27,8 +27,8 @@ Follow the five steps below to install the latest version of Python on Windows. (The instructions were written with Windows 10 and Python 3.11.0 in mind, but should be nearly or fully identical with Windows 11 or other modern versions of Python.) -> If you want a fresh start, you may want to first uninstall any other versions of Python on your PC, including those -> from the Microsoft Store, if you have any. This can be done in the ["Apps & features" Windows +> If you want a fresh start, you should check for and uninstall any versions of Python already on your PC, including +> those from the Microsoft Store. This can be done in the ["Apps & features" Windows > settings](/static/images/content/python-on-windows/ms_store_uninstall.png) (type "apps and features" into the Start > Menu to find it). Though it's fine to have multiple versions of Python installed at once. It can be useful for testing > version compatibility or for working on projects made in a certain version. Only uninstall things if you want to. @@ -208,8 +208,8 @@ Virtual environments ("venvs") are a way of giving each of your Python projects in, so different projects can have different versions of the same dependencies. For example, suppose you are working on two websites that both use the Python web-framework [Django](https://www.djangoproject.com/download/). One site is older and requires Django 3.2, and the other is newer and requires Django 4.1. If you install Django globally, no matter if -you install 3.2 or 4.1, one or the or the other of the projects will have the wrong version. But if you make a virtual -environment for each project you can install the required Django version for each separately. +you install 3.2 or 4.1, one or the or the other of the projects will have the wrong version. If instead you make a +virtual environment for each project, you can install the required Django version for each separately. Virtual environments are not exclusive to Windows, but the commands to use them can differ a bit across operating systems. Check out the [official docs](https://docs.python.org/3/tutorial/venv.html#creating-virtual-environments) and diff --git a/pydis_site/apps/content/resources/guides/python-guides/windows/microsoft-store.md b/pydis_site/apps/content/resources/guides/python-guides/windows/microsoft-store.md index 82e8d851..8b496779 100644 --- a/pydis_site/apps/content/resources/guides/python-guides/windows/microsoft-store.md +++ b/pydis_site/apps/content/resources/guides/python-guides/windows/microsoft-store.md @@ -12,6 +12,10 @@ Store](https://apps.microsoft.com/store/search/python) as an alternative to usin [python.org](https://www.python.org). **We recommend you install Python on Windows using the [full installer from python.org](https://www.python.org/downloads), and not from the Microsoft store wherever possible!** +Installing Python from [python.org](https://www.python.org) does not normally require administrator privileges, but if +for whatever reason don't have permission to install it, don't feel bad if you get the Microsoft Store version instead. +Better some Python than no Python. + You can follow [this guide](../installing-and-using-python) to install Python from python.org and more Python Windows releases can be found [here](https://www.python.org/downloads/windows). @@ -66,6 +70,8 @@ Here are some common issues with using Python from the Microsoft Store: latest Python version you can but if you ever need earlier than 3.7 for testing or for working on older code, the store can't help. +## Uninstalling + If you have the Microsoft Store version of Python and want to uninstall it, you can search "uninstall" in the Start menu to open up the "Apps & features" settings and filter by "python". The Python app that has a console in the icon and "Python Software Foundation" under the name is the Microsoft Store one. Click it and hit Uninstall. |