GeezerVison

Documentation build overview

📚 cpython-previews | 🛠️ Build #34785155 | 📁 Comparing f23c28f against main (a64b7ec)

  🔍 Preview build  

This is ready to review now.

CC @terryjreedy @CAM-Gerlach if you're interested, could you please take a look?

This now incorporates some additional fixes from Hugo from my previous re-write of the introduction.

I ask however, that suggestions for the existing text not be made in this PR (but in a future one). I tried to focus on moving content as-is, so that it'll be easier for people to go through it in the Git history.

If there are no comments, I plan to merge this next week.

I will then be sending PRs for each section, as I'd like to tidy them up, so if anything comes up I can also address it then.

Moving the how-tos down seems sensible. The crazy side-by-side diff is nearly useless for review. Instead I looked at the old and new html renderings in separate tabs, in particular the sidebars. Much, much improved. As near as I could tell, everything went somewhere.

I think some headers could be reworded, but that should be done in a separate PR, where the old and new versions would appear side-by-side for review. This includes the how-to names.

Much, much improved.

That's nice to hear, thanks Terry :-)

This includes the how-to names.

Yes, I plan to do that, along with some other little changes in the section in a follow up PR.

Please backport and get this in the releases next week.

Thanks @StanFromIreland for the PR 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14, 3.15.
🐍🍒⛏🤖 I'm not a witch! I'm not a witch!

GH-158318 is a backport of this pull request to the 3.15 branch.

Sorry, @StanFromIreland, I could not cleanly backport this to 3.13 due to a conflict.
Please backport using cherry_picker on command line.

cherry_picker 4c3cb33db7a9eb037334c77d07d498aefe0ad282 3.13

GH-158319 is a backport of this pull request to the 3.14 branch.

GH-158321 is a backport of this pull request to the 3.13 branch.