gh-59551: Rename Doc/library/dialog.rst to tkinter.dialog.rst

[serhiy-storchaka]

• Issue: Tkinter extention modules have no documentation #59551

[serhiy-storchaka]

I was surprised by finding the part of the Tkinter documentation in uncommon place.

[read-the-docs-community]

Documentation build overview

📚 cpython-previews | 🛠️ Build #33201844 | 📁 Comparing 243f30c against main (d47c27e)

🔍 Preview build

8 files changed · + 1 added · ± 6 modified · - 1 deleted

+Added

• library/tkinter.dialog.html

±Modified

• py-modindex.html
• library/index.html
• library/tk.html
• library/tkinter.colorchooser.html
• library/tkinter.html
• whatsnew/changelog.html

-Deleted

• library/dialog.html

[hugovk]

We'll need to have a redirect from the old:

https://cpython-previews--151656.org.readthedocs.build/en/151656/library/dialog.html

to the new:

https://cpython-previews--151656.org.readthedocs.build/en/151656/library/tkinter.dialog.html

We use the https://github.com/sphinx-doc/sphinxext-rediraffe extension in the devguide:

https://github.com/python/devguide/blob/e0ecbef0fad11be66fd16858bf9835de7ce6107b/conf.py#L123

We generally try and avoid extensions in this repo to help downstream redistributors, but I think it's okay to put it in _OPTIONAL_EXTENSIONS -- we'll have the redirect for our site, and it's not such a big deal if downstreams don't.

---

Ping also @encukou, because we've recently been talking about how to split up large pages into smaller ones, and he's been working on (or planning to) develop tooling for that which could be useful here. But that's a somewhat different issue, and Rediraffe should be fine for this tkinter redirect.

[encukou]

For now, you can add an :orphan: page like Doc/distributing/index.rst.