Doc: Clarify doc about turtle.reset() and angle measurement unit
オープン
まだ誰も着手していません。
docs
topic-tkinter
- 主要言語
- Python
- スター
- 77.2k
- フォーク
- 35.9k
- PR マージ指標
- PR 指標を取得中
説明
Documentation
The turtle module has a couple of functions that could cause misconceptions about the reset function and angle measurement unit.
turtle.reset():
Delete the turtle’s drawings from the screen, re-center the turtle and set variables to the default values.
- Re-center is not always true. It depends on the turtle mode. I think the right thing to say is something like "send the turtle to the (0, 0) position".
- What variables?
turtle.left()/rigth():
Turn turtle left/rigth by angle units. (Units are by default degrees, but can be set via the [degrees()](https://docs.python.org/3/library/turtle.html#turtle.degrees) and [radians()](https://docs.python.org/3/library/turtle.html#turtle.radians) functions.) Angle orientation depends on the turtle mode, see [mode()](https://docs.python.org/3/library/turtle.html#turtle.mode).
It is said that the unit defaults are degrees. But if we run turtle.radians() and after turtle.reset(), the unit doesn't change to degrees.
turtle.degrees(fullcircle=360.0)
Set angle measurement units, i.e. set number of “degrees” for a full circle. Default value is 360 degrees.
turtle.radians()
Set the angle measurement units to radians. Equivalent to degrees(2*math.pi).
These two last functions say nothing about the default unit. (and missing a "See also" in each)
Linked PRs
- gh-138879
- gh-138882
コントリビューションガイド
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
調査の方向性
turtle モジュールのドキュメントから始め、reset()、left()/right()、degrees()、radians()、mode() の項目を確認してください。reset() の動作と角度単位のデフォルト値を明確にし、どの変数がリセットされるかを説明し、不足している See also 参照を追加してください。リンクされた PRs は、この作業がすでに進行中である可能性を示しています。
索引モデルが issue の本文から書いたものです。
評価
- 技術スタック
- python
- 領域
- documentation
- issue の種類
- ドキュメント
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 活発さ
- 停滞
- 明瞭さ
- おおむね明確
- 初心者へのやさしさ
- 25/100