Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

add extra instruction for windows users (installation #1016

Open
wants to merge 1 commit into
base: main
Choose a base branch
from
Open

add extra instruction for windows users (installation #1016

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion docs/intro/installation.rst
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -75,14 +75,18 @@ There are countless ways to install software on Windows. Here we describe *one*
possible approach that should work on any Windows computer, like one that you
may have just bought.

Unless you know what you are doing, try to follow the steps precisely.
If something is not working, you probably did something wrong in the previous step.
It is often faster and easier to start over than trying to find out what went wrong.


Python:
Windows itself does not ship with Python, it must be installed separately.
If you already did that, please check the :find-out-more:`on Python
versions <fom-py2v3>`, if it matches the requirements. Otherwise, head over
to the `download section of the Python website
<https://www.python.org/downloads>`_, and download an installer. Unless you
have specific requirements, go with the 64bit installer of the latest
have specific requirements, go with the 4bit installer of the latest
Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This change should be removed.

Python 3 release.

.. windows-wit:: Avoid installing Python from the Windows store
Expand All @@ -96,6 +100,8 @@ Python:
as this is required for subsequent installation steps and interactive use later on.
Other than that, using the default installation settings is just fine.

If you did everything right, typing ``python --version`` in the command prompt should give you an answer.
Copy link
Contributor

@JoKeyser JoKeyser Jan 3, 2025 •
edited
Loading

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Here you could mention the kind of correct answer you'd expect (instead of an "answer" like "command not found").

For example, something like "If you did everything right, typing python --version in the command prompt should show your installed Python version, like 'Python 3.x.y'."


Git:
Windows also does not come with Git. If you happen to have it installed already,
please check, if you have configured it for command line use. You should be able
Expand Down