Rework bob documentation

This tweaks the bob exercise splitting the description into two files, per the v3 change. - introduction.md which gives context, and - instructions.md which tells the student what the task actually consists of. It also slightly tweaks the introduction to feel more friendly, and structures the instructions to help clarify exactly what responses are in Bob's repertoire.
exercism · Feb 22, 2023 · 3e5eb9d · 3e5eb9d
1 parent 3bd102f
commit 3e5eb9d
Show file tree

Hide file tree

Showing 3 changed files with 29 additions and 16 deletions.
diff --git a/exercises/bob/description.md b/exercises/bob/description.md
diff --git a/exercises/bob/instructions.md b/exercises/bob/instructions.md
@@ -0,0 +1,19 @@
+# Instructions
+
+Your task is to determine what Bob will reply to someone when they say something to him or ask him a question.
+
+Bob only ever answers one of five things:
+
+- **"Sure."**
+  This is his response if you ask him a question, such as "How are you?"
+  The convention used for questions is that it ends with a question mark.
+- **"Whoa, chill out!"**
+  This is his answer if you YELL AT HIM.
+  The convention used for yelling is ALL CAPITAL LETTERS.
+- **"Calm down, I know what I'm doing!"**
+  This is what he says if you yell a question at him.
+- **"Fine. Be that way!"**
+  This is how he responds to silence.
+  The convention used for silence is nothing, or various combinations of whitespace characters.
+- **"Whatever."**
+  This is what he answers to anything else.
diff --git a/exercises/bob/introduction.md b/exercises/bob/introduction.md
@@ -0,0 +1,10 @@
+# Introduction
+
+Bob is a [lackadaisical][] teenager.
+He likes to think that he's very cool.
+And he definitely doesn't get excited about things.
+That wouldn't be cool.
+
+When people talk to him, his responses are pretty limited.
+
+[lackadaisical]: https://www.collinsdictionary.com/dictionary/english/lackadaisical