Sync recent prob-spec changes

exercises/practice/all-your-base/.docs/instructions.md

@@ -1,32 +1,27 @@
 # Instructions
 
-Convert a number, represented as a sequence of digits in one base, to any other base.
+Convert a sequence of digits in one base, representing a number, into a sequence of digits in another base, representing the same number.
 
-Implement general base conversion.
-Given a number in base **a**, represented as a sequence of digits, convert it to base **b**.
-
-## Note
-
-- Try to implement the conversion yourself.
-  Do not use something else to perform the conversion for you.
+~~~~exercism/note
+Try to implement the conversion yourself.
+Do not use something else to perform the conversion for you.
+~~~~
 
 ## About [Positional Notation][positional-notation]
 
 In positional notation, a number in base **b** can be understood as a linear combination of powers of **b**.
 
 The number 42, _in base 10_, means:
 
-`(4 * 10^1) + (2 * 10^0)`
+`(4 × 10¹) + (2 × 10⁰)`
 
 The number 101010, _in base 2_, means:
 
-`(1 * 2^5) + (0 * 2^4) + (1 * 2^3) + (0 * 2^2) + (1 * 2^1) + (0 * 2^0)`
+`(1 × 2⁵) + (0 × 2⁴) + (1 × 2³) + (0 × 2²) + (1 × 2¹) + (0 × 2⁰)`
 
 The number 1120, _in base 3_, means:
 
-`(1 * 3^3) + (1 * 3^2) + (2 * 3^1) + (0 * 3^0)`
-
-I think you got the idea!
+`(1 × 3³) + (1 × 3²) + (2 × 3¹) + (0 × 3⁰)`
 
 _Yes. Those three numbers above are exactly the same. Congratulations!_
 

exercises/practice/all-your-base/.docs/introduction.md

@@ -0,0 +1,8 @@
+# Introduction
+
+You've just been hired as professor of mathematics.
+Your first week went well, but something is off in your second week.
+The problem is that every answer given by your students is wrong!
+Luckily, your math skills have allowed you to identify the problem: the student answers _are_ correct, but they're all in base 2 (binary)!
+Amazingly, it turns out that each week, the students use a different base.
+To help you quickly verify the student answers, you'll be building a tool to translate between bases.

exercises/practice/dnd-character/.docs/instructions.md

@@ -3,13 +3,13 @@
 For a game of [Dungeons & Dragons][dnd], each player starts by generating a character they can play with.
 This character has, among other things, six abilities; strength, dexterity, constitution, intelligence, wisdom and charisma.
 These six abilities have scores that are determined randomly.
-You do this by rolling four 6-sided dice and record the sum of the largest three dice.
+You do this by rolling four 6-sided dice and recording the sum of the largest three dice.
 You do this six times, once for each ability.
 
 Your character's initial hitpoints are 10 + your character's constitution modifier.
 You find your character's constitution modifier by subtracting 10 from your character's constitution, divide by 2 and round down.
 
-Write a random character generator that follows the rules above.
+Write a random character generator that follows the above rules.
 
 For example, the six throws of four dice may look like:
 
@@ -22,10 +22,11 @@ For example, the six throws of four dice may look like:
 
 Because constitution is 3, the constitution modifier is -4 and the hitpoints are 6.
 
-## Notes
-
+~~~~exercism/note
 Most programming languages feature (pseudo-)random generators, but few programming languages are designed to roll dice.
 One such language is [Troll][troll].
 
-[dnd]: https://en.wikipedia.org/wiki/Dungeons_%26_Dragons
 [troll]: https://di.ku.dk/Ansatte/?pure=da%2Fpublications%2Ftroll-a-language-for-specifying-dicerolls(84a45ff0-068b-11df-825d-000ea68e967b)%2Fexport.html
+~~~~
+
+[dnd]: https://en.wikipedia.org/wiki/Dungeons_%26_Dragons

exercises/practice/dnd-character/.docs/introduction.md

@@ -0,0 +1,10 @@
+# Introduction
+
+After weeks of anticipation, you and your friends get together for your very first game of [Dungeons & Dragons][dnd] (D&D).
+Since this is the first session of the game, each player has to generate a character to play with.
+The character's abilities are determined by rolling 6-sided dice, but where _are_ the dice?
+With a shock, you realize that your friends are waiting for _you_ to produce the dice; after all it was your idea to play D&D!
+Panicking, you realize you forgot to bring the dice, which would mean no D&D game.
+As you have some basic coding skills, you quickly come up with a solution: you'll write a program to simulate dice rolls.
+
+[dnd]: https://en.wikipedia.org/wiki/Dungeons_%26_Dragons

exercises/practice/minesweeper/.docs/instructions.md

@@ -1,19 +1,13 @@
 # Instructions
 
-Add the mine counts to a completed Minesweeper board.
+Your task is to add the mine counts to empty squares in a completed Minesweeper board.
+The board itself is a rectangle composed of squares that are either empty (`' '`) or a mine (`'*'`).
 
-Minesweeper is a popular game where the user has to find the mines using numeric hints that indicate how many mines are directly adjacent (horizontally, vertically, diagonally) to a square.
+For each empty square, count the number of mines adjacent to it (horizontally, vertically, diagonally).
+If the empty square has no adjacent mines, leave it empty.
+Otherwise replace it with the adjacent mines count.
 
-In this exercise you have to create some code that counts the number of mines adjacent to a given empty square and replaces that square with the count.
-
-The board is a rectangle composed of blank space (' ') characters.
-A mine is represented by an asterisk (`*`) character.
-
-If a given space has no adjacent mines at all, leave that square blank.
-
-## Examples
-
-For example you may receive a 5 x 4 board like this (empty spaces are represented here with the '·' character for display on screen):
+For example, you may receive a 5 x 4 board like this (empty spaces are represented here with the '·' character for display on screen):
 
 ```text
 ·*·*·
@@ -22,7 +16,7 @@ For example you may receive a 5 x 4 board like this (empty spaces are represente
 ·····
 ```
 
-And your code will transform it into this:
+Which your code should transform into this:
 
 ```text
 1*3*1

exercises/practice/minesweeper/.docs/introduction.md

@@ -0,0 +1,5 @@
+# Introduction
+
+[Minesweeper][wikipedia] is a popular game where the user has to find the mines using numeric hints that indicate how many mines are directly adjacent (horizontally, vertically, diagonally) to a square.
+
+[wikipedia]: https://en.wikipedia.org/wiki/Minesweeper_(video_game)

exercises/practice/roman-numerals/.meta/tests.toml

@@ -30,6 +30,9 @@ description = "6 is VI"
 [ff3fb08c-4917-4aab-9f4e-d663491d083d]
 description = "9 is IX"
 
+[6d1d82d5-bf3e-48af-9139-87d7165ed509]
+description = "16 is XVI"
+
 [2bda64ca-7d28-4c56-b08d-16ce65716cf6]
 description = "27 is XXVII"
 
@@ -42,6 +45,9 @@ description = "49 is XLIX"
 [d5b283d4-455d-4e68-aacf-add6c4b51915]
 description = "59 is LIX"
 
+[4465ffd5-34dc-44f3-ada5-56f5007b6dad]
+description = "66 is LXVI"
+
 [46b46e5b-24da-4180-bfe2-2ef30b39d0d0]
 description = "93 is XCIII"
 
@@ -51,38 +57,35 @@ description = "141 is CXLI"
 [267f0207-3c55-459a-b81d-67cec7a46ed9]
 description = "163 is CLXIII"
 
+[902ad132-0b4d-40e3-8597-ba5ed611dd8d]
+description = "166 is CLXVI"
+
 [cdb06885-4485-4d71-8bfb-c9d0f496b404]
 description = "402 is CDII"
 
 [6b71841d-13b2-46b4-ba97-dec28133ea80]
 description = "575 is DLXXV"
 
+[dacb84b9-ea1c-4a61-acbb-ce6b36674906]
+description = "666 is DCLXVI"
+
 [432de891-7fd6-4748-a7f6-156082eeca2f]
 description = "911 is CMXI"
 
 [e6de6d24-f668-41c0-88d7-889c0254d173]
 description = "1024 is MXXIV"
 
-[bb550038-d4eb-4be2-a9ce-f21961ac3bc6]
-description = "3000 is MMM"
-
-[6d1d82d5-bf3e-48af-9139-87d7165ed509]
-description = "16 is XVI"
-
-[4465ffd5-34dc-44f3-ada5-56f5007b6dad]
-description = "66 is LXVI"
-
-[902ad132-0b4d-40e3-8597-ba5ed611dd8d]
-description = "166 is CLXVI"
-
-[dacb84b9-ea1c-4a61-acbb-ce6b36674906]
-description = "666 is DCLXVI"
-
 [efbe1d6a-9f98-4eb5-82bc-72753e3ac328]
 description = "1666 is MDCLXVI"
 
+[bb550038-d4eb-4be2-a9ce-f21961ac3bc6]
+description = "3000 is MMM"
+
 [3bc4b41c-c2e6-49d9-9142-420691504336]
 description = "3001 is MMMI"
 
+[2f89cad7-73f6-4d1b-857b-0ef531f68b7e]
+description = "3888 is MMMDCCCLXXXVIII"
+
 [4e18e96b-5fbb-43df-a91b-9cb511fe0856]
 description = "3999 is MMMCMXCIX"

exercises/practice/roman-numerals/roman-numerals.test

@@ -140,5 +140,10 @@ test roman-27 "3999 is MMMCMXCIX" -body {
     toroman 3999
 } -returnCodes ok -result "MMMCMXCIX"
 
+skip roman-28
+test roman-28 "3888 is MMMDCCCLXXXVIII" -body {
+    toroman 3888
+} -returnCodes ok -result "MMMDCCCLXXXVIII"
+
 
 cleanupTests

exercises/practice/scrabble-score/.docs/instructions.md

@@ -1,40 +1,25 @@
 # Instructions
 
-Given a word, compute the Scrabble score for that word.
+Your task is to compute a word's Scrabble score by summing the values of its letters.
 
-## Letter Values
+The letters are valued as follows:
 
-You'll need these:
+| Letter                       | Value |
+| ---------------------------- | ----- |
+| A, E, I, O, U, L, N, R, S, T | 1     |
+| D, G                         | 2     |
+| B, C, M, P                   | 3     |
+| F, H, V, W, Y                | 4     |
+| K                            | 5     |
+| J, X                         | 8     |
+| Q, Z                         | 10    |
 
-```text
-Letter                           Value
-A, E, I, O, U, L, N, R, S, T       1
-D, G                               2
-B, C, M, P                         3
-F, H, V, W, Y                      4
-K                                  5
-J, X                               8
-Q, Z                               10
-```
-
-## Examples
-
-"cabbage" should be scored as worth 14 points:
+For example, the word "cabbage" is worth 14 points:
 
 - 3 points for C
-- 1 point for A, twice
-- 3 points for B, twice
+- 1 point for A
+- 3 points for B
+- 3 points for B
+- 1 point for A
 - 2 points for G
 - 1 point for E
-
-And to total:
-
-- `3 + 2*1 + 2*3 + 2 + 1`
-- = `3 + 2 + 6 + 3`
-- = `5 + 9`
-- = 14
-
-## Extensions
-
-- You can play a double or a triple letter.
-- You can play a double or a triple word.

exercises/practice/scrabble-score/.docs/introduction.md

@@ -0,0 +1,7 @@
+# Introduction
+
+[Scrabble][wikipedia] is a word game where players place letter tiles on a board to form words.
+Each letter has a value.
+A word's score is the sum of its letters' values.
+
+[wikipedia]: https://en.wikipedia.org/wiki/Scrabble