Restructure the `turtle` documentation

オープン

#157,847 2026年9月20日に作成コメント 0 件リアクション 0 件担当者 1 名 GitHub で見る

@StanFromIreland がすでに取り組んでいます。

2026年9月20日から。

評価

この issue はまだ評価されていません。

説明

docs

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

主要言語: Python
スター: 77.2k
フォーク: 36k
平均マージ: 1日 9時間
マージ済み PR（30日）: 558

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
リポジトリをフォークし、ブランチを切って変更します。
issue 番号を参照したプルリクエストを送ります。

python/cpython のほかの issue

docs: Zipfile contains a 13-years outdated warning regarding path sanitization オープン

docs pending

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

python/cpython#157339 · コメント 10 件 · 2026年9月11日に作成
pydoc HTML output is not responsive and has no viewport meta in released versions オープン

stdlib type-feature

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

python/cpython#155601 · コメント 2 件 · 2026年8月12日に作成
`zipfile.ZipFile.writestr()` raises `AttributeError` instead of accepting `os.PathLike` objects (e.g. `pathlib.Path`) オープン

stdlib type-feature

難易度 2/5 1〜3時間初心者へのやさしさ 72/100

python/cpython#153771 · コメント 5 件 · 2026年7月15日に作成
BOLT-WARNING: specifying numeric value "1" for option -icf is deprecated オープン

build type-bug

難易度 2/5 1〜3時間初心者へのやさしさ 76/100

python/cpython#149708 · コメント 1 件 · 2026年5月12日に作成
Expose message ID list from `ReferencesHeader` オープン

stdlib topic-email type-feature

難易度 2/5 1〜3時間初心者へのやさしさ 70/100

python/cpython#148797 · コメント 3 件 · 2026年4月20日に作成

python/cpython の issue をすべて見る

似ている issue

Schema regression: derivation conversion_failure reverted オープン

難易度 1/5 1時間未満初心者へのやさしさ 90/100

elong0527/yamaa#708 · 2026年9月21日に作成
RadioSelectButtonGroup does not render as a button group through bootstrap_field オープン

bug

難易度 2/5 1〜3時間初心者へのやさしさ 86/100

zostera/django-bootstrap4#894 · 2026年9月21日に作成
[Bug]: control_ui.show_thinking = false does not stop the live reasoning stream, so thinking events and done.reasoning_content still reach the web UI オープン

難易度 2/5 1〜3時間初心者へのやさしさ 78/100

use-agent-os/agent-os#3276 · 2026年9月21日に作成
Build fails with LTO enabled: conflicting types for z_shared_sw_isr_table between isr_tables.c and sw_isr_table.h オープン

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

zephyrproject-rtos/zephyr#119726 · 2026年9月21日に作成
[Bug]: redact_sensitive_text does not recognise Discord bot tokens オープン

area/auth bug comp/agent P3 platform/discord type/security

難易度 2/5 1〜3時間初心者へのやさしさ 88/100

NousResearch/hermes-agent#117848 · 2026年9月21日に作成

Python の issue をもっと見る