Skip to content

Commit 0975e42

Browse files
mikeckennedymikeckennedy
committed
Apply rumdl fmt, fix MD044 rewriting the repo URL
Formatting only: list markers to '-', blank lines before the horizontal rules following the HTML anchors, blank lines after changelog headings, and a consistent horizontal rule style. One non-cosmetic fix: MD044's proper-names rule was rewriting the link text "https://github.com/..." to "https://GitHub.com/...", so the page would render a capitalized URL on every fmt run. The link text is now descriptive rather than a raw URL, which sidesteps the rule and also drops the dangling "visit the GitHub repository here".
1 parent 3adbd96 commit 0975e42

2 files changed

Lines changed: 15 additions & 8 deletions

File tree

‎change-log.md‎

Lines changed: 6 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -7,6 +7,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
77
## [Unreleased]
88

99
### Fixed
10+
1011
- **`python -V` now actually works after following the guide.** `uv python install 3.14` only creates a versioned `python3.14` executable, so the macOS and Linux verification steps told readers to run `python -V` and expect success when they'd get `command not found`. All three platforms now install with `--default`, which creates the `python` and `python3` executables the guide promises.
1112
- Verification step is now consistent across Windows, macOS, and Linux (previously Windows used `uv run python -V` while macOS and Linux claimed bare `python -V` worked).
1213
- Corrected sample command output, which showed a `Searching for Python 3.14` line that uv does not print and omitted the installed executable names.
@@ -16,6 +17,7 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
1617
- Fixed two silently-ignored keys in `.rumdl.toml`: `disabled-rules` → `disable` and `MD048.code-fence-style` → `MD048.style`. Because the disable list never loaded, the guide's intentional inline HTML was being flagged on every run.
1718

1819
### Added
20+
1921
- Note that `--default` emits an experimental warning, so readers don't think the install failed.
2022
- Note that the patch version and install time in sample output will differ, so the page doesn't read as wrong the moment 3.14.7 ships.
2123
- Warning against using `--default` when installing multiple Python versions, plus how to intentionally repoint `python` at a different version later.
@@ -24,20 +26,23 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
2426
## [2025.12.10] - python-2025-guide
2527

2628
### Changed
29+
2730
- **Completely modernized Python installation guide for 2025**
2831
- Replaced 10 different installation methods with unified uv approach
2932
- Simplified guide from 454 lines to ~256 lines
3033
- Updated target Python version from 3.12 to 3.14.2
3134
- Guide now works identically across Windows, macOS, and Linux
32-
35+
3336
### Added
37+
3438
- Installation instructions using uv (one-command install per platform)
3539
- Section on working with Python projects and virtual environments
3640
- Section on managing multiple Python versions with uv
3741
- "Why uv?" explanation section
3842
- Link to Talk Python episode #476 about unified Python packaging with uv
3943

4044
### Removed
45+
4146
- Anaconda distribution installation instructions
4247
- Chocolatey package manager for Windows
4348
- Homebrew package manager for macOS
@@ -50,4 +55,3 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).
5055
## Previous Versions
5156

5257
The guide existed prior to this changelog. This represents the first tracked release using the modernized uv-based approach.
53-

‎install-python.md‎

Lines changed: 9 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -15,11 +15,12 @@ The process is just two steps:
1515

1616
That's it! Jump to your operating system to get started:
1717

18-
* [**Windows**](#windows)
19-
* [**macOS**](#macos)
20-
* [**Linux**](#linux)
18+
- [**Windows**](#windows)
19+
- [**macOS**](#macos)
20+
- [**Linux**](#linux)
2121

2222
<a id="windows" style="margin-bottom: 10px; display: inline-block;"></a>
23+
2324
_________________________
2425

2526
## Windows
@@ -70,6 +71,7 @@ Python 3.14.6
7071
**You're all set!** 🎉
7172

7273
<a id="macos" style="margin-bottom: 10px; display: inline-block;"></a>
74+
7375
_________________________
7476

7577
## macOS
@@ -120,6 +122,7 @@ Python 3.14.6
120122
**You're all set!** 🎉
121123

122124
<a id="linux" style="margin-bottom: 10px; display: inline-block;"></a>
125+
123126
_________________________
124127

125128
## Linux
@@ -271,10 +274,10 @@ _________________________
271274

272275
One tool. No complexity. Just Python.
273276

274-
-------------------------------
277+
_________________________
275278

276279
## Corrections and Improvements
277280

278-
If you find a problem or have a suggestion to make this page better, please visit the GitHub repository here. Note that this is not intended for tech support but rather for genuine, broadly applicable improvements to the instructions:
281+
If you find a problem or have a suggestion to make this page better, please open an issue on GitHub. Note that this is not intended for tech support but rather for genuine, broadly applicable improvements to the instructions:
279282

280-
[**https://github.com/talkpython/installing-python**](https://github.com/talkpython/installing-python)
283+
[**talkpython/installing-python**](https://github.com/talkpython/installing-python)

0 commit comments

Comments
 (0)