From 3e5eb9d444ff783f537d712b1e6b00bd5f4469bf Mon Sep 17 00:00:00 2001 From: Katrina Owen Date: Thu, 16 Feb 2023 15:02:17 +0100 Subject: [PATCH] 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. --- exercises/bob/description.md | 16 ---------------- exercises/bob/instructions.md | 19 +++++++++++++++++++ exercises/bob/introduction.md | 10 ++++++++++ 3 files changed, 29 insertions(+), 16 deletions(-) delete mode 100644 exercises/bob/description.md create mode 100644 exercises/bob/instructions.md create mode 100644 exercises/bob/introduction.md diff --git a/exercises/bob/description.md b/exercises/bob/description.md deleted file mode 100644 index 0f00dc4843..0000000000 --- a/exercises/bob/description.md +++ /dev/null @@ -1,16 +0,0 @@ -# Description - -Bob is a lackadaisical teenager. -In conversation, his responses are very limited. - -Bob answers 'Sure.' if you ask him a question, such as "How are you?". - -He answers 'Whoa, chill out!' if you YELL AT HIM (in all capitals). - -He answers 'Calm down, I know what I'm doing!' if you yell a question at him. - -He says 'Fine. Be that way!' if you address him without actually saying anything. - -He answers 'Whatever.' to anything else. - -Bob's conversational partner is a purist when it comes to written communication and always follows normal rules regarding sentence punctuation in English. diff --git a/exercises/bob/instructions.md b/exercises/bob/instructions.md new file mode 100644 index 0000000000..bb702f7bbe --- /dev/null +++ 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 new file mode 100644 index 0000000000..ea4a80776b --- /dev/null +++ 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