setup/videos_on_windows_installs/README.md

48 lines
3.1 KiB
Markdown
Raw Permalink Normal View History

2025-10-22 03:57:59 +00:00
# Videos about Windows installs
To share code with others, you need to be able to follow instructions exactly.
On Windows, you need to be running version 11. Version 10 is no longer getting security updates.
To be able to work with the tools I'll provide, you also need to be able to use:
1. A text editor
2. A specific version of Python (we'll use the most recent version of Python 3.13) and and a package manager (I suggest trying uv.)
3. Git
4. Two shell programs:
- Powershell
- Git Bash
The videos in this folder show you how to install one free text editor (Notepad++) that Git can use; Python3.13; Git for Windows (which includes Git Bash); PowerShell 7; and a popular new package manager called, uv. I also show how to install a new text editor that is under developement called Zed that you may want to try. (It is safer to use the much older Notepad++ for the narrow purpose of being an editor for Git commit and merge messages.)
If instead of trying Zed for most of your text editing you would rather use Visual Studio Code, that is a reasonable choice for now, but be aware that it is already on the path to enshitification.
**Pay attention to the specifics.**
a. Microsoft offers two different programs with very similar names: Windows PowerShell and PowerShell. Windows PowerShell is installed by default as part of Windows. The instructions that follow refer to PowerShell version 7. It does not come with Windows. It has to be installed separately.
b. The version of Python matters. The instructions I'll provide will work with Python 3.13 but not with Python 3.14.
**The order in which you do these installs also matters.**
a. You need to install Notepad++ before you install Git for Windows.
b. You need to install PowerShell 7 before you install uv (at least if you use the method that I suggest. There are others.)
**Other Potential Confusions**
i) During the installation process, you will sometimes need to click through a confirmation screen where Windows asks if it is ok to do the install. This is not something that the videos can capture.
ii) You may not get the same defaults for checked boxes and filled in forms in the installer for Git for Windows. Whatever you see as initial defaults, be sure to check the boxes and fill in the forms as in the video.
iii) The options you see in the videos for installing Python, and Powershell may not be available to you if you already have a version of the underlying program installed.
- If you do have a version installed, you may be presented with different screens that give you the option to upgrade or repair the existing install and the option to uninstall.
- The safest way to proceed is to uninstall and then run the installer again so you can specify the exact options in the videos.
- If you try to do something else, such as upgrade or repair, you might fail to specify exactly the same selections as in the videos. If so, other things may break. If they do; go back; uninstall; follow the install videos exactly.
- If you think that you can disregard the instructions offered here and just improvise, go for it, but understand that you are on your own.