Restructure the `turtle` documentation
未關閉
@StanFromIreland 已經在處理了。
開始於 2026年9月20日。
docs
- 主要語言
- Python
- 星號
- 77.2k
- 分支
- 36k
- 平均合併
- 1 天 9 小時
- 30 天內合併 PR
- 558
描述
Documentation
Currently, it's a little messy. We have obsolete sections (https://github.com/python/cpython/pull/157846) and several that seem to duplicate each other. Inspired by https://github.com/python/cpython/issues/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-157846
- gh-157849
- gh-157850
- gh-157851
- gh-157854
- gh-157868
貢獻指南
從這裡開始
- 先讀完整個 Issue,再讀專案的貢獻指南。
- 在 Issue 下留言說明你要接手 —— 這能避免兩個人做同樣的事。
- Fork 儲存庫,在一個分支上完成修改。
- 送出 Pull Request,並在描述裡引用這個 Issue 編號。
評估
這個 Issue 還沒有評估資料。