readme: update Python manual install instructions for Windows

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?

[MikeMcC399]

• closesOutdated Python 3.14 manual install instructions on Windows #3264

Checklist

• npm install && npm run lint && npm test passes
• documentation is changed or added
• commit message follows commit guidelines

Situation

Python instructions to install on Windows changed with the release of Python 3.14 in October 2025.

Python 3.14 documentation says:

To obtain Python from the CPython team, use the Python Install Manager. This is a standalone tool that makes Python available as global commands on your Windows machine, integrates with the system, and supports updates over time. You can download the Python Install Manager from python.org/downloads or through the Microsoft Store app.

Python 3.14 is not available as a separate package in the Microsoft Store, unlike Python 3.12 and 3.13.

The Python Install Manager can be used to install 3.14 and other versions.

Description of change

In the README > On Windows section change the manual install instructions to:

Follow the instructions in Using Python on Windows to install the current version of Python.

[MikeMcC399]

Preview

https://github.com/MikeMcC399/node-gyp/blob/python-install-windows-doc/README.md#on-windows

[MikeMcC399]

@cclauss

Alternatively we could point to the Windows install manager at:

• https://www.python.org/downloads/windows

Pointing to the documentation https://docs.python.org/3/using/windows.html gives more comprehensive information, including different choices of where to get the Python install manager for Windows and how to use the Python install manager.

When I started to migrate to Python 3.14 I found that I needed this documentation.

If you want to point instead to the download page, https://www.python.org/downloads (one level higher) presents simpler information. The contents depends on the operating system where the browser is running and from Windows it looks like this:

this is easier on the eyes compared to https://www.python.org/downloads/windows

https://www.python.org/downloads/windows

---

Another possibility would be to use https://www.python.org/downloads and include a link to https://docs.python.org/3/using/windows.html

That may be the best way.

Would be great to hear also from @StefanStojanovic about his thoughts!

[MikeMcC399]

My original (short) suggestion, which delegates the instructions to the Python docs, is:

Follow the instructions in Using Python on Windows to install the current version of Python.

An alternate longer suggestion, which links directly to the download location options would be:

To install the current version of Python use the Python Install Manager, which can be installed from the Microsoft Store app or downloaded and installed from python/downloads. Refer to the documentation Using Python on Windows for Python Install Manager usage instructions.

I prefer the shorter version.

[StefanStojanovic]

Generally speaking, I'm more in favor of shorter docs, as long as it gives all the info you need.

[MikeMcC399]

Is readme: all right for the commit message? I took it from release-please-config.json or would doc: or docs: be preferred?

[MikeMcC399]

@StefanStojanovic

Thanks for your feedback! Are you (or @cclauss) ready to approve this PR? If not, could you advise what I should change?