From e3eecc868d2a816fc2aa384ad25daf173f50af1f Mon Sep 17 00:00:00 2001 From: Daniele Procida Date: Sat, 22 Jul 2023 11:10:59 +0200 Subject: [PATCH 1/2] Amend the introduction to the turtle graphics documentation This patch helps clarify the purpose, value and scope of the turtle graphics module, by rewriting the introduction according to the pattern: * a single sentence that says **what the product (or thing) is**, as succinctly as possible * a brief description of **what it does** * a statement of its purpose or **the problem it solves** * a note about **whom it is useful for** --- Doc/library/turtle.rst | 24 +++++++++++++++++++++--- 1 file changed, 21 insertions(+), 3 deletions(-) diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst index c9ce955a6d2ba4..7b706c3a1d9912 100644 --- a/Doc/library/turtle.rst +++ b/Doc/library/turtle.rst @@ -19,9 +19,27 @@ Introduction ============ -Turtle graphics is a popular way for introducing programming to kids. It was -part of the original Logo programming language developed by Wally Feurzeig, -Seymour Papert and Cynthia Solomon in 1967. +Turtle graphics is an implementation of `the popular geometric drawing tools +introduced in Logo `_, developed by Wally Feurzeig, Seymour Papert and Cynthia Solomon +in 1967. + +In Python, turtle graphics provides a representation of a physical "turtle" +(a little robot with a pen) that draws on a sheet of paper on the floor. + +It's a very effective and well-proven way for learners to encounter +programming concepts and interaction with software, as it provides instant, +visible feedback. It also provides convenient access to graphical output +in general. + +Turtle drawing was originally created as an educational tool, to be used by +teachers in the classroom. For the programmer who needs to produce some +graphical output it can be a way to do that without the overhead of +introducing more complex or external libraries into their work. + + +Get started +=========== Imagine a robotic turtle starting at (0, 0) in the x-y plane. After an ``import turtle``, give it the command ``turtle.forward(15)``, and it moves (on-screen!) 15 pixels in the From 196acc3673d39f45c22d8ef816f7703025e3bbe9 Mon Sep 17 00:00:00 2001 From: Daniele Procida Date: Sat, 22 Jul 2023 12:13:36 +0200 Subject: [PATCH 2/2] Update Doc/library/turtle.rst Co-authored-by: Hugo van Kemenade --- Doc/library/turtle.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/Doc/library/turtle.rst b/Doc/library/turtle.rst index 7b706c3a1d9912..f14a677b7dd88c 100644 --- a/Doc/library/turtle.rst +++ b/Doc/library/turtle.rst @@ -27,7 +27,7 @@ in 1967. In Python, turtle graphics provides a representation of a physical "turtle" (a little robot with a pen) that draws on a sheet of paper on the floor. -It's a very effective and well-proven way for learners to encounter +It's an effective and well-proven way for learners to encounter programming concepts and interaction with software, as it provides instant, visible feedback. It also provides convenient access to graphical output in general.