about summary refs log tree commit diff stats
path: root/tutorial
diff options
context:
space:
mode:
authorKartik K. Agaram <vc@akkartik.com>2021-10-22 16:09:26 -0700
committerKartik K. Agaram <vc@akkartik.com>2021-10-22 16:09:56 -0700
commitf2ee8c1fb6980cb1960bbb4b737ea650643d41b4 (patch)
tree5935068f07861f57d7248239bb5fb6329742b4c4 /tutorial
parent6293c438a67e9d6ce636a45a61b37a6759825871 (diff)
downloadmu-f2ee8c1fb6980cb1960bbb4b737ea650643d41b4.tar.gz
better phrasing thanks to feedback from sejo
Diffstat (limited to 'tutorial')
-rw-r--r--tutorial/index.md13
1 files changed, 7 insertions, 6 deletions
diff --git a/tutorial/index.md b/tutorial/index.md
index 95eec2bb..e23e0542 100644
--- a/tutorial/index.md
+++ b/tutorial/index.md
@@ -254,16 +254,17 @@ skeleton. We'll try out the following statements, one by one:
 
 Before typing in each one, write down whether you expect an error. After
 trying it out, compare your answer. It can also be useful to write down the
-exact error you see, and what it means, in your own words. Flipping the
-"runbook" that way can be a useful aid to memory when you see an error for
-real, during a real programming session.
+exact error you see, and what it means, in your own words.
 
 (Also, don't forget to delete the statement you typed in before you move on to
 trying out the next one.)
 
-Runbooks are a handy tool for working with computers. In a runbook you write
-instructions to your future self or for others you're working with. They're
-instructions for programming people, not computers.
+Making notes about error messages is an example of a more general trick called
+a [runbook](https://en.wikipedia.org/wiki/Runbook). Runbooks are aids to
+memory, scripts for what to do when you run into a problem. People think worse
+in the presence of stress, and runbooks can help reduce the need for thinking
+in the presence of stress. They're a way of programming people (your future
+self or others) rather than computers.
 
 ## Task 7: variables in registers, variables in memory (again)