Description

StanFromIreland

opened on Sep 20, 2026

Issue body actions

Documentation

Currently, it's a little messy. We have obsolete sections (#157846) and several that seem to duplicate each other. Inspired by #94635, I will restructure the documentation remove the duplicated content, and to have a clearer order and table of contents than what we have now. A rough plan:

turtle --- Turtle graphics
  (intro prose, merges "Introduction" and "Get started",
   keep the sidebar image, then optional-module include plus the Tk
   note from the how-to, then a "This document includes four main
   sections:" like in sqlite3 documentation)

Tutorial
  Starting a turtle environment
  Basic drawing
  Making algorithmic patterns
  etc.

Reference
  Turtle methods and functions             (current "Methods of RawTurtle/Turtle...")
  Screen methods and functions             (current "Methods of TurtleScreen/Screen...")
  Classes                                  (current "Public classes")
  Exceptions

How-to guides
  How to automatically begin and end filling
  How to use the turtle module namespace
  How to use turtle graphics in a script
  How to use object-oriented turtle graphics
  How to use help                          (moved from "Help and configuration")
  How to configure Screen and Turtles      (moved from "Help and configuration")

Explanation
  The object-oriented interface            (current "Explanation")

turtledemo --- Demo scripts                (unchanged)

Linked PRs

• gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sections from turtle docs #157846
• [3.15] gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sections from turtle docs (GH-157846) #157849
• [3.14] gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sections from turtle docs (GH-157846) #157850
• [3.13] gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sections from turtle docs (#157846) #157851
• gh-157847: Rewrite turtle module docs introduction #157854
• gh-157847: Reorganize turtle documentation #157868
• [3.15] gh-157847: Rewrite turtle module docs introduction (GH-157854) #158094
• [3.14] gh-157847: Rewrite turtle module docs introduction (GH-157854) #158096
• [3.13] gh-157847: Rewrite turtle module docs introduction (GH-157854) #158104
• [3.15] gh-157847: Reorganize turtle documentation (GH-157868) #158318
• [3.14] gh-157847: Reorganize turtle documentation (GH-157868) #158319
• [3.13] gh-157847: Reorganize turtle documentation (GH-157868) #158321
• gh-157847: Tidy up turtle motion docstrings and docs in turtle module #158330
• [3.15] gh-157847: Tidy up turtle motion docstrings and docs in turtle module (GH-158330) #158365
• [3.14] gh-157847: Tidy up turtle motion docstrings and docs in turtle module (GH-158330) #158366
• [3.13] gh-157847: Tidy up turtle motion docstrings and docs in turtle module (GH-158330) #158367
• gh-157847: Improve more turtle docstrings and docs #158562
• [3.14] gh-157847: Improve more turtle docstrings and docs (GH-158562) #159171
• [3.15] gh-157847: Improve more turtle docstrings and docs (GH-158562) #159172
• gh-157847: Clean up another portion of the turtle documentation #160620
• [3.15] gh-157847: Clean up another portion of the turtle documentation (GH-160620) #161484
• [3.14] gh-157847: Clean up another portion of the turtle documentation (GH-160620) #161485

Reacted by Maciej Olko

Activity

1. StanFromIreland

   self-assigned this

   on Sep 20, 2026
2. StanFromIreland

   added

   docsDocumentation in the Doc dirDocumentation in the Doc dir

   on Sep 20, 2026
3. StanFromIreland

   added this to Turtle issues 🐢on Sep 20, 2026
4. github-project-automation

   added this to docs issueson Sep 20, 2026
5. github-project-automation

   moved this to Todo in docs issueson Sep 20, 2026
6. StanFromIreland

   added 3 commits that reference this issue on Sep 20, 2026

   gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sections fr…

   5962fc2

   [3.14] gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sect…

   3fb942f

   [3.13] gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sect…

   cb74ead
7. m-aciek

   changed the title [-]Resutructure the `turtle` documentation[/-] [+]Restructure the `turtle` documentation[/+] on Sep 20, 2026
8. hugovk

   added a commit that references this issue on Sep 21, 2026

   [3.15] gh-157847: Remove obsolete "Changes since Python 2.6/3.0" sect…

   4ceaa3e
9. StanFromIreland

   added 2 commits that reference this issue on Sep 24, 2026

   gh-157847: Rewrite `turtle` module docs introduction (#157854)

   9b3fc89

   [3.14] gh-157847: Rewrite `turtle` module docs introduction (GH-157854)…

   821ebc7
10. hugovk

    added a commit that references this issue on Sep 24, 2026

    [3.15] gh-157847: Rewrite `turtle` module docs introduction (GH-157854)…

    1d32a34
11. StanFromIreland

    added 2 commits that reference this issue on Sep 24, 2026

    [3.13] gh-157847: Rewrite `turtle` module docs introduction (GH-157854)…

    7f5140b

    gh-157847: Reorganize `turtle` documentation (#157868)

    4c3cb33
12. 8 remaining items
13. StanFromIreland

    added 2 commits that reference this issue on Oct 11, 2026

    [3.15] gh-157847: Improve more `turtle` docstrings and docs (GH-158562)…

    8b02517

    [3.14] gh-157847: Improve more `turtle` docstrings and docs (GH-158562)…

    35ab5bc
14. orsenthil

    added a commit that references this issue on Oct 11, 2026

    pythongh-157847: Improve more `turtle` docstrings and docs (python#15…

    36af3b3
15. kevinprimeraquecreo-stack

    added this to Project_VKon Oct 18, 2026
16. github-project-automation

    moved this to Todo in Project_VKon Oct 18, 2026
17. kevinprimeraquecreo-stack

    added this to Project_VKon Oct 18, 2026
18. StanFromIreland

    added a commit that references this issue on Oct 20, 2026

    gh-157847: Re-write more of the `turtle` reference docs (#159685)

    f071bac
19. JelleZijlstra

    added 2 commits that reference this issue on Oct 21, 2026

    [3.14] gh-157847: Re-write more of the `turtle` reference docs (GH-15…

    a3f95bb

    [3.15] gh-157847: Re-write more of the `turtle` reference docs (GH-15…

    815057b
20. StanFromIreland commented on Nov 5, 2026

    

    StanFromIreland

    on Nov 5, 2026

    MemberAuthor

    More actions

    Issues need addressing: #161386 (comment)
21. StanFromIreland

    added a commit that references this issue on Nov 6, 2026

    gh-157847: Clean up another portion of the `turtle` documentation (#1…

    b76b6e7
22. miss-islington

    added 2 commits that reference this issue on Nov 6, 2026

    pythongh-157847: Clean up another portion of the `turtle` documentati…

    463773f

    pythongh-157847: Clean up another portion of the `turtle` documentati…

    519ca6e
23. StanFromIreland

    added 2 commits that reference this issue on Nov 6, 2026

    [3.15] gh-157847: Clean up another portion of the `turtle` documentat…

    521ce9a

    [3.14] gh-157847: Clean up another portion of the `turtle` documentat…

    f64e515

Issue actions