gh-137777: Fix remove Program Frameworks chapter and relocate its modules

[rimi0108]

• Issue: Docs: remove Program Framework chapter #137777

---

📚 Documentation preview 📚: https://cpython-previews--137796.org.readthedocs.build/

[rimi0108]

@corona10

[rimi0108]

I think the document path is wrong. Let me check :(

[corona10]

LGTM

I checked that the preview page is well rendered too :)

https://cpython-previews--137796.org.readthedocs.build/en/137796/library/frameworks.html

[corona10]

Let's wait @AA-Turner and @hugovk for the English feedback.

[hugovk]

Thanks for the PR!

I'm thinking about where to put the modules in their new locations. Should the be added to the end of the list, or put somewhere more prominent further up the list.

I don't have a strong position on the following, it's kind of based on my use of the libraries, which is far from objective :)

• I think cmd is okay at the end; the others look more important to me.

• I was going to suggest putting shlex second, after posix; but posix begins with a warning: "Do not import this module directly". So maybe put shlex first?

• turtle is important for education, but perhaps not if you're specifically reading the "Graphical user interfaces with Tk" chapter, and last position is fine?

[hugovk]

Let's update this file's header to sentence case:

-Graphical User Interfaces with Tk
+Graphical user interfaces with Tk

[rimi0108]

Thanks for the PR!

I'm thinking about where to put the modules in their new locations. Should the be added to the end of the list, or put somewhere more prominent further up the list.

I don't have a strong position on the following, it's kind of based on my use of the libraries, which is far from objective :)

• I think cmd is okay at the end; the others look more important to me.
• I was going to suggest putting shlex second, after posix; but posix begins with a warning: "Do not import this module directly". So maybe put shlex first?
• turtle is important for education, but perhaps not if you're specifically reading the "Graphical user interfaces with Tk" chapter, and last position is fine?

Thanks for the guidance!
Based on your suggestions, I’ll place shlex at the top, keep posix right after it (since it starts with a “do not import directly” warning), move cmd to the end, and keep turtle last within the Tk GUI chapter context.

[adorilson]

I'm thinking about where to put the modules in their new locations. Should the be added to the end of the list, or put somewhere more prominent further up the list.

I don't have a strong position on the following, it's kind of based on my use of the libraries, which is far from objective :)

I have a strong and objective position here: alphabetical order. :)

It makes it easier for everyone to locate a module, but mainly for blind users of screen readers.

Edit: another issue/PR could make this change for every chapter listing modules.

[hugovk]

Thanks, looks good!

I'll leave this open for a bit in case Adam wants to check it.

[hugovk]

I have a strong and objective position here: alphabetical order. :)

It makes it easier for everyone to locate a module, but mainly for blind users of screen readers.

This also makes it easier to decide/debate what order to put things in :)

Looks okay to do this for cmdlinelibs.rst and unix.rst.

We'd have to take care with "Graphical User Interfaces with Tk", would it make sense to start with the current tkinter.rst intro page?

   tkinter.rst
   tkinter.colorchooser.rst
   tkinter.font.rst
   dialog.rst
   tkinter.messagebox.rst
   tkinter.scrolledtext.rst
   tkinter.dnd.rst
   tkinter.ttk.rst
   idle.rst
   turtle.rst

And they render like this, according to titles not filenames, where dialog.rst is "Tkinter Dialogs" and shouldn't be first:

• Graphical User Interfaces with Tk
  • tkinter — Python interface to Tcl/Tk
  • tkinter.colorchooser — Color choosing dialog
  • tkinter.font — Tkinter font wrapper
  • Tkinter Dialogs
  • tkinter.messagebox — Tkinter message prompts
  • tkinter.scrolledtext — Scrolled Text Widget
  • tkinter.dnd — Drag and drop support
  • tkinter.ttk — Tk themed widgets
  • IDLE — Python editor and shell

Edit: another issue/PR could make this change for every chapter listing modules.

Yeah, probably better to discuss separately from this one.

[adorilson]

And they render like this, according to titles not filenames, where dialog.rst is "Tkinter Dialogs" and shouldn't be first:

Yeah. The order must be according to the title (what the reader sees), not filenames.

The problem here is that "Tkinter Dialogs" is not a module itself, but something like a sub-chapter (why isn't tkinter.colorchooser — Color choosing dialog here ?).

I think "Graphical User Interfaces with Tk" deserves its discussion. I've touched on this in the initial post.

For now, "Tkinter Dialogs" could come after tkinter.* stuffs. Currently, it looks like an alien. :)

[miss-islington-app]

Thanks @rimi0108 for the PR, and @AA-Turner for merging it 🌮🎉.. I'm working now to backport this PR to: 3.13, 3.14.
🐍🍒⛏🤖

[bedevere-app]

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

[bedevere-app]

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