gh-157847: Improve more turtle docstrings and docs - #158562
StanFromIreland wants to merge 4 commits into
Conversation
Documentation build overview
|
|
To review, I needed to experiment. To refresh my memory, I followed the tutorial. In "Starting a turtle environment", the import is insufficient. It does not 'start a turtle environment'. Add I would add this to this PR. |
Co-authored-by: Terry Reedy <tjreedy@udel.edu>
|
Yeah, the tutorial (like all of the sections) needs some work. But, I'm happy to apply your suggestion now if that aids reviewing :-) However, I switched |
|
When you're done making the requested changes, leave the comment: |
|
Yes, |
Co-authored-by: Terry Reedy <tjreedy@udel.edu>
|
I have made the requested changes; please review again |
|
Thanks for making the requested changes! @terryjreedy: please review the changes made to this pull request. |
This continues the work started in #158281 and #158330. It improves the reference docs and docstrings, modernising them, making them easier to understand/clearer, and consistent.
Yes, a few could reasonably be classified as churn, however, the turtle module is, frankly, quite messy in places. I think these changes improve readability and, as a result, maintainability, so I intend to tidy up similar issues. They should also have relatively little impact on useful Git history, since the majority of the affected lines date back to the original port in 97cf99f.
turtledocumentation #157847