Sync recent docs and metadata changes (#51)

exercism · Sep 5, 2024 · b32db34 · b32db34
1 parent 32988e4
commit b32db34
Show file tree

Hide file tree

Showing 34 changed files with 71 additions and 38 deletions.
diff --git a/exercises/practice/acronym/.docs/instructions.md b/exercises/practice/acronym/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Convert a phrase to its acronym.
 

diff --git a/exercises/practice/acronym/.meta/config.json b/exercises/practice/acronym/.meta/config.json
@@ -15,5 +15,5 @@
   },
   "blurb": "Convert a long phrase to its acronym.",
   "source": "Julien Vanier",
-  "source_url": "https://github.com/monkbroc/"
+  "source_url": "https://github.com/monkbroc"
 }
diff --git a/exercises/practice/armstrong-numbers/.docs/instructions.md b/exercises/practice/armstrong-numbers/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 An [Armstrong number][armstrong-number] is a number that is the sum of its own digits each raised to the power of the number of digits.
 

diff --git a/exercises/practice/armstrong-numbers/.meta/config.json b/exercises/practice/armstrong-numbers/.meta/config.json
@@ -15,5 +15,5 @@
   },
   "blurb": "Determine if a number is an Armstrong number.",
   "source": "Wikipedia",
-  "source_url": "https://en.wikipedia.org/wiki/Narcissistic_number/"
+  "source_url": "https://en.wikipedia.org/wiki/Narcissistic_number"
 }
diff --git a/exercises/practice/clock/.docs/instructions.md b/exercises/practice/clock/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Implement a clock that handles times without dates.
 

diff --git a/exercises/practice/clock/.meta/config.json b/exercises/practice/clock/.meta/config.json
@@ -14,5 +14,5 @@
     ]
   },
   "blurb": "Implement a clock that handles times without dates.",
-  "source": "Pairing session with Erin Drummond."
+  "source": "Pairing session with Erin Drummond"
 }
diff --git a/exercises/practice/darts/.docs/instructions.md b/exercises/practice/darts/.docs/instructions.md
@@ -1,6 +1,6 @@
-# Description
+# Instructions
 
-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
 
@@ -28,4 +28,4 @@ The scoreboard image was created by [habere-et-dispertire][habere-et-dispertire]
 [cartesian-coordinates]: https://www.mathsisfun.com/data/cartesian-coordinates.html
 [real-numbers]: https://www.mathsisfun.com/numbers/real-numbers.html
 [habere-et-dispertire]: https://exercism.org/profiles/habere-et-dispertire
-[inkscape]: https://en.wikipedia.org/wiki/Inkscape
+[inkscape]: https://en.wikipedia.org/wiki/Inkscape
diff --git a/exercises/practice/darts/.meta/config.json b/exercises/practice/darts/.meta/config.json
@@ -13,6 +13,6 @@
       ".meta/Example.bat"
     ]
   },
-  "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/practice/difference-of-squares/.docs/instructions.md b/exercises/practice/difference-of-squares/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Find the difference between the square of the sum and the sum of the squares of the first N natural numbers.
 

diff --git a/exercises/practice/difference-of-squares/.meta/config.json b/exercises/practice/difference-of-squares/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "Find the difference between the square of the sum and the sum of the squares of the first N natural numbers.",
-  "source": "Problem 6 at Project Euler"
+  "source": "Problem 6 at Project Euler",
+  "source_url": "https://projecteuler.net/problem=6"
 }
diff --git a/exercises/practice/food-chain/.docs/instructions.md b/exercises/practice/food-chain/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Generate the lyrics of the song 'I Know an Old Lady Who Swallowed a Fly'.
 

diff --git a/exercises/practice/food-chain/.meta/config.json b/exercises/practice/food-chain/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "Generate the lyrics of the song 'I Know an Old Lady Who Swallowed a Fly'.",
-  "source": "Wikipedia"
+  "source": "Wikipedia",
+  "source_url": "https://en.wikipedia.org/wiki/There_Was_an_Old_Lady_Who_Swallowed_a_Fly"
 }
diff --git a/exercises/practice/grains/.docs/instructions.md b/exercises/practice/grains/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Calculate the number of grains of wheat on a chessboard given that the number on each square doubles.
 

diff --git a/exercises/practice/grains/.meta/config.json b/exercises/practice/grains/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "Calculate the number of grains of wheat on a chessboard given that the number on each square doubles.",
-  "source": "The CodeRanch Cattle Drive, Assignment 6"
+  "source": "The CodeRanch Cattle Drive, Assignment 6",
+  "source_url": "https://coderanch.com/wiki/718824/Grains"
 }
diff --git a/exercises/practice/hamming/.docs/instructions.md b/exercises/practice/hamming/.docs/instructions.md
@@ -1,6 +1,6 @@
-# Description
+# Instructions
 
-Calculate the Hamming Distance between two DNA strands.
+Calculate the Hamming distance between two DNA strands.
 
 Your body is made up of cells that contain DNA.
 Those cells regularly wear out and need replacing, which they achieve by dividing into daughter cells.
@@ -9,18 +9,18 @@ In fact, the average human body experiences about 10 quadrillion cell divisions
 When cells divide, their DNA replicates too.
 Sometimes during this process mistakes happen and single pieces of DNA get encoded with the incorrect information.
 If we compare two strands of DNA and count the differences between them we can see how many mistakes occurred.
-This is known as the "Hamming Distance".
+This is known as the "Hamming distance".
 
-We read DNA using the letters C,A,G and T.
+We read DNA using the letters C, A, G and T.
 Two strands might look like this:
 
     GAGCCTACTAACGGGAT
     CATCGTAATGACGGCCT
     ^ ^ ^  ^ ^    ^^
 
-They have 7 differences, and therefore the Hamming Distance is 7.
+They have 7 differences, and therefore the Hamming distance is 7.
 
-The Hamming Distance is useful for lots of things in science, not just biology, so it's a nice phrase to be familiar with :)
+The Hamming distance is useful for lots of things in science, not just biology, so it's a nice phrase to be familiar with :)
 
 ## Implementation notes
 

diff --git a/exercises/practice/hello-world/.docs/instructions.md b/exercises/practice/hello-world/.docs/instructions.md
@@ -8,7 +8,7 @@ Just say "Hello, World!".
 The objectives are simple:
 
 - Modify the provided code so that it produces the string "Hello, World!".
-- <u>[If In Local Development]</u> Run the test suite and make sure that it succeeds.
+- Run the test suite and make sure that it succeeds.
 - Submit your solution and check it at the website.
 
 If everything goes well, you will be ready to fetch your first real exercise.

diff --git a/exercises/practice/nth-prime/.docs/instructions.md b/exercises/practice/nth-prime/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Given a number n, determine what the nth prime is.
 

diff --git a/exercises/practice/nth-prime/.meta/config.json b/exercises/practice/nth-prime/.meta/config.json
@@ -15,5 +15,6 @@
     ]
   },
   "blurb": "Given a number n, determine what the nth prime is.",
-  "source": "A variation on Problem 7 at Project Euler"
+  "source": "A variation on Problem 7 at Project Euler",
+  "source_url": "https://projecteuler.net/problem=7"
 }
diff --git a/exercises/practice/nucleotide-count/.docs/instructions.md b/exercises/practice/nucleotide-count/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Each of us inherits from our biological parents a set of chemical instructions known as DNA that influence how our bodies are constructed.
 All known life depends on DNA!

diff --git a/exercises/practice/proverb/.docs/instructions.md b/exercises/practice/proverb/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 For want of a horseshoe nail, a kingdom was lost, or so the saying goes.
 

diff --git a/exercises/practice/proverb/.meta/config.json b/exercises/practice/proverb/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "For want of a horseshoe nail, a kingdom was lost, or so the saying goes. Output the full text of this proverbial rhyme.",
-  "source": "Wikipedia"
+  "source": "Wikipedia",
+  "source_url": "https://en.wikipedia.org/wiki/For_Want_of_a_Nail"
 }
diff --git a/exercises/practice/raindrops/.docs/introduction.md b/exercises/practice/raindrops/.docs/introduction.md
@@ -0,0 +1,3 @@
+# Introduction
+
+Raindrops is a slightly more complex version of the FizzBuzz challenge, a classic interview question.
diff --git a/exercises/practice/resistor-color/.docs/instructions.md b/exercises/practice/resistor-color/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 If you want to build something using a Raspberry Pi, you'll probably use _resistors_.
 For this exercise, you need to know two things about them:

diff --git a/exercises/practice/resistor-color/.meta/config.json b/exercises/practice/resistor-color/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "Convert a resistor band's color to its numeric representation.",
-  "source": "Maud de Vries, Erik Schierboom"
+  "source": "Maud de Vries, Erik Schierboom",
+  "source_url": "https://github.com/exercism/problem-specifications/issues/1458"
 }
diff --git a/exercises/practice/reverse-string/.docs/introduction.md b/exercises/practice/reverse-string/.docs/introduction.md
@@ -0,0 +1,5 @@
+# Introduction
+
+Reversing strings (reading them from right to left, rather than from left to right) is a surprisingly common task in programming.
+
+For example, in bioinformatics, reversing the sequence of DNA or RNA strings is often important for various analyses, such as finding complementary strands or identifying palindromic sequences that have biological significance.
diff --git a/exercises/practice/reverse-string/.meta/config.json b/exercises/practice/reverse-string/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "Reverse a given string.",
-  "source": "Introductory challenge to reverse an input string"
+  "source": "Introductory challenge to reverse an input string",
+  "source_url": "https://medium.freecodecamp.org/how-to-reverse-a-string-in-javascript-in-3-different-ways-75e4763c68cb"
 }
diff --git a/exercises/practice/series/.docs/instructions.md b/exercises/practice/series/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Given a string of digits, output all the contiguous substrings of length `n` in that string in the order that they appear.
 

diff --git a/exercises/practice/series/.meta/config.json b/exercises/practice/series/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "Given a string of digits, output all the contiguous substrings of length `n` in that string.",
-  "source": "A subset of the Problem 8 at Project Euler."
+  "source": "A subset of the Problem 8 at Project Euler",
+  "source_url": "https://projecteuler.net/problem=8"
 }
diff --git a/exercises/practice/sieve/.docs/introduction.md b/exercises/practice/sieve/.docs/introduction.md
@@ -0,0 +1,7 @@
+# Introduction
+
+You bought a big box of random computer parts at a garage sale.
+You've started putting the parts together to build custom computers.
+
+You want to test the performance of different combinations of parts, and decide to create your own benchmarking program to see how your computers compare.
+You choose the famous "Sieve of Eratosthenes" algorithm, an ancient algorithm, but one that should push your computers to the limits.
diff --git a/exercises/practice/sieve/.meta/config.json b/exercises/practice/sieve/.meta/config.json
@@ -15,5 +15,6 @@
     ]
   },
   "blurb": "Use the Sieve of Eratosthenes to find all the primes from 2 up to a given number.",
-  "source": "Sieve of Eratosthenes at Wikipedia"
+  "source": "Sieve of Eratosthenes at Wikipedia",
+  "source_url": "https://en.wikipedia.org/wiki/Sieve_of_Eratosthenes"
 }
diff --git a/exercises/practice/square-root/.docs/instructions.md b/exercises/practice/square-root/.docs/instructions.md
@@ -1,4 +1,4 @@
-# Description
+# Instructions
 
 Given a natural radicand, return its square root.
 

diff --git a/exercises/practice/square-root/.meta/config.json b/exercises/practice/square-root/.meta/config.json
@@ -14,5 +14,6 @@
     ]
   },
   "blurb": "Given a natural radicand, return its square root.",
-  "source": "wolf99"
+  "source": "wolf99",
+  "source_url": "https://github.com/exercism/problem-specifications/pull/1582"
 }
diff --git a/exercises/practice/two-fer/.docs/introduction.md b/exercises/practice/two-fer/.docs/introduction.md
@@ -0,0 +1,8 @@
+# Introduction
+
+In some English accents, when you say "two for" quickly, it sounds like "two fer".
+Two-for-one is a way of saying that if you buy one, you also get one for free.
+So the phrase "two-fer" often implies a two-for-one offer.
+
+Imagine a bakery that has a holiday offer where you can buy two cookies for the price of one ("two-fer one!").
+You take the offer and (very generously) decide to give the extra cookie to someone else in the queue.
diff --git a/exercises/practice/two-fer/.meta/config.json b/exercises/practice/two-fer/.meta/config.json
@@ -14,5 +14,5 @@
     ]
   },
   "blurb": "Create a sentence of the form \"One for X, one for me.\".",
-  "source": "https://github.com/exercism/problem-specifications/issues/757"
+  "source_url": "https://github.com/exercism/problem-specifications/issues/757"
 }