From 3c13c2d93d0fe322e3bacfe1674f6ec466e8b1b3 Mon Sep 17 00:00:00 2001 From: iddinev Date: Wed, 27 Dec 2023 16:53:10 +0200 Subject: [PATCH 1/2] Fix typo in tutorials.rst --- tutorials.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. From cb9994f6db98358260c150d054189f27db449759 Mon Sep 17 00:00:00 2001 From: iddinev Date: Wed, 27 Dec 2023 16:54:50 +0200 Subject: [PATCH 2/2] Fix typo/styling error in compass.rst --- compass.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/compass.rst b/compass.rst index 7e3496f..08f2ad4 100644 --- a/compass.rst +++ b/compass.rst @@ -58,7 +58,7 @@ And it yields the answer. Using the compass ------------------ -The compass is particularly effective when you think that you think you (or even the documentation in front of you) are doing one thing - but you are troubled by a sense of doubt, or by some difficulty in the work. The compass forces you to stop and reconsider. +The compass is particularly effective when you think that you (or even the documentation in front of you) are doing one thing - but you are troubled by a sense of doubt, or by some difficulty in the work. The compass forces you to stop and reconsider. Especially when you are trying to find your initial bearings, use the compass's terms flexibly; don't get fixated on the exact names.