diff --git a/tutorials.rst b/tutorials.rst index c8dd452..5c4ab8d 100644 --- a/tutorials.rst +++ b/tutorials.rst @@ -116,7 +116,7 @@ At every step of a tutorial, the user experiences a moment of anxiety: will this Keep up a narrative of expectations: "You will notice that ..."; "After a few moments, the server responds with ...". Show the user actual example output, or even the exact expected output. -If you know know in advance what the likely signs of going wrong are, consider flagging them: "If the output doesn't show ..., you have probably forgotten to ...". +If you know in advance what the likely signs of going wrong are, consider flagging them: "If the output doesn't show ..., you have probably forgotten to ...". It's helpful to prepare the user for possibly surprising actions: "The command will probably return several hundred lines of logs in your terminal." @@ -254,4 +254,4 @@ Meanwhile, the cooking lesson might be framed around the idea of learning how to The child learns all this by working alongside you in the kitchen; in its own time, at its own pace, **through the activities** you do together, and not from the things you say or show. -With a young child, you will often find that the lesson suddenly has to end before you'd completed what you set out to do. This is normal and expected; children have short attention spans. But as long as the child managed to achieve something - however small - and enjoyed doing it, it will have laid down something in the construction of its technical expertise, that can be returned to and built upon next time. \ No newline at end of file +With a young child, you will often find that the lesson suddenly has to end before you'd completed what you set out to do. This is normal and expected; children have short attention spans. But as long as the child managed to achieve something - however small - and enjoyed doing it, it will have laid down something in the construction of its technical expertise, that can be returned to and built upon next time.