Exercises no longer ask developers to 'write a function' (#2396) (#2406)

* Exercises no longer ask developers to 'write a function' (#2396) * Change requests from review (avoiding `return` and using more specific language) * Update missed metadata instances, missed return, and bravely fix the nucleotide-codons description * Remediate `Write some code` in alphametics exercise description --------- Signed-off-by: Adam Henley <[email protected]>
exercism · Mar 28, 2024 · d4c868f · d4c868f
1 parent cb9374f
commit d4c868f
Show file tree

Hide file tree

Showing 9 changed files with 11 additions and 13 deletions.
diff --git a/exercises/alphametics/description.md b/exercises/alphametics/description.md
@@ -1,6 +1,6 @@
 # Description
 
-Write a function to solve alphametics puzzles.
+Given an alphametics puzzle, find the correct solution.
 
 [Alphametics][alphametics] is a puzzle where letters in words are replaced with numbers.
 
@@ -26,6 +26,4 @@ This is correct because every letter is replaced by a different number and the w
 
 Each letter must represent a different digit, and the leading digit of a multi-digit number must not be zero.
 
-Write a function to solve alphametics puzzles.
-
 [alphametics]: https://en.wikipedia.org/wiki/Alphametics
diff --git a/exercises/alphametics/metadata.toml b/exercises/alphametics/metadata.toml
@@ -1,2 +1,2 @@
 title = "Alphametics"
-blurb = "Write a function to solve alphametics puzzles."
+blurb = "Given an alphametics puzzle, find the correct solution."
diff --git a/exercises/darts/description.md b/exercises/darts/description.md
@@ -1,6 +1,6 @@
 # Description
 
-Write a function that returns the earned points in a single toss of a Darts game.
+Calculate the points scored in a single toss of a Darts game.
 
 [Darts][darts] is a game where players throw darts at a [target][darts-target].
 
@@ -16,7 +16,7 @@ In our particular instance of the game, the target rewards 4 different amounts o
 The outer circle has a radius of 10 units (this is equivalent to the total radius for the entire target), the middle circle a radius of 5 units, and the inner circle a radius of 1.
 Of course, they are all centered at the same point — that is, the circles are [concentric][] defined by the coordinates (0, 0).
 
-Write a function that given a point in the target (defined by its [Cartesian coordinates][cartesian-coordinates] `x` and `y`, where `x` and `y` are [real][real-numbers]), returns the correct amount earned by a dart landing at that point.
+Given a point in the target (defined by its [Cartesian coordinates][cartesian-coordinates] `x` and `y`, where `x` and `y` are [real][real-numbers]), calculate the correct score earned by a dart landing at that point.
 
 ## Credit
 

diff --git a/exercises/darts/metadata.toml b/exercises/darts/metadata.toml
@@ -1,3 +1,3 @@
 title = "Darts"
-blurb = "Write a function that returns the earned points in a single toss of a Darts game."
+blurb = "Calculate the points scored in a single toss of a Darts game."
 source = "Inspired by an exercise created by a professor Della Paolera in Argentina"
diff --git a/exercises/flatten-array/description.md b/exercises/flatten-array/description.md
@@ -2,7 +2,7 @@
 
 Take a nested list and return a single flattened list with all values except nil/null.
 
-The challenge is to write a function that accepts an arbitrarily-deep nested list-like structure and returns a flattened structure without any nil/null values.
+The challenge is to take an arbitrarily-deep nested list-like structure and produce a flattened structure without any nil/null values.
 
 For example:
 

diff --git a/exercises/go-counting/description.md b/exercises/go-counting/description.md
@@ -5,10 +5,10 @@ Count the scored points on a Go board.
 In the game of go (also known as baduk, igo, cờ vây and wéiqí) points are gained by completely encircling empty intersections with your stones.
 The encircled intersections of a player are known as its territory.
 
-Write a function that determines the territory of each player.
+Calculate the territory of each player.
 You may assume that any stones that have been stranded in enemy territory have already been taken off the board.
 
-Write a function that determines the territory which includes a specified coordinate.
+Determine the territory which includes a specified coordinate.
 
 Multiple empty intersections may be encircled at once and for encircling only horizontal and vertical neighbors count.
 In the following diagram the stones which matter are marked "O" and the stones that don't are marked "I" (ignored).

diff --git a/exercises/nucleotide-codons/description.md b/exercises/nucleotide-codons/description.md
@@ -1,6 +1,6 @@
 # Description
 
-Write a function that returns the name of an amino acid a particular codon, possibly using shorthand, encodes for.
+Translate a given codon into the name of the amino acid that it encodes, possibly using shorthand.
 
 In DNA sequences of 3 nucleotides, called codons, encode for amino acids.
 Often several codons encode for the same amino acid.

diff --git a/exercises/nucleotide-codons/metadata.toml b/exercises/nucleotide-codons/metadata.toml
@@ -1,2 +1,2 @@
 title = "Nucleotide Codons"
-blurb = "Write a function that returns the name of an amino acid a particular codon, possibly using shorthand, encodes for."
+blurb = "Translate a given codon into the amino acid it encodes, possibly using shorthand."
diff --git a/exercises/parallel-letter-frequency/description.md b/exercises/parallel-letter-frequency/description.md
@@ -4,4 +4,4 @@ Count the frequency of letters in texts using parallel computation.
 
 Parallelism is about doing things in parallel that can also be done sequentially.
 A common example is counting the frequency of letters.
-Create a function that returns the total frequency of each letter in a list of texts and that employs parallelism.
+Employ parallelism to calculate the total frequency of each letter in a list of texts.