update READMEs using configlet (#714)

* update READMEs using configlet

* update READMEs with update-docs.sh

Author: sjwarner

exercises/darts/README.md

@@ -1,19 +1,20 @@
+# Darts
+
 Write a function that returns the earned points in a single toss of a Darts game.
 
 [Darts](https://en.wikipedia.org/wiki/Darts) is a game where players
 throw darts to a [target](https://en.wikipedia.org/wiki/Darts#/media/File:Darts_in_a_dartboard.jpg).
 
 In our particular instance of the game, the target rewards with 4 different amounts of points, depending on where the dart lands:
 
-- If the dart lands outside the target, player earns no points (0 points).
-- If the dart lands in the outer circle of the target, player earns 1 point.
-- If the dart lands in the middle circle of the target, player earns 5 points.
-- If the dart lands in the inner circle of the target, player earns 10 points.
+* If the dart lands outside the target, player earns no points (0 points).
+* If the dart lands in the outer circle of the target, player earns 1 point.
+* If the dart lands in the middle circle of the target, player earns 5 points.
+* If the dart lands in the inner circle of the target, player earns 10 points.
 
 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 to the same point (That is, the circles are [concentric](http://mathworld.wolfram.com/ConcentricCircles.html)) defined by the coordinates (0, 0).
 
 Write a function that given a point in the target (defined by its `real` cartesian coordinates `x` and `y`), returns the correct amount earned by a dart landing in that point.
-
 ## Running the tests
 
 To run the tests, run the command `dotnet test` from within the exercise directory.
@@ -23,5 +24,9 @@ To run the tests, run the command `dotnet test` from within the exercise directo
 For more detailed information about the C# track, including how to get help if
 you're having trouble, please visit the exercism.io [C# language page](http://exercism.io/languages/csharp/resources).
 
+## Source
+
+Inspired by an excersie created by a professor Della Paolera in Argentina
+
 ## Submitting Incomplete Solutions
 It's possible to submit an incomplete solution so you can see how others have completed the exercise.

exercises/pythagorean-triplet/README.md

@@ -7,6 +7,12 @@ which,
 a**2 + b**2 = c**2
 ```
 
+and such that,
+
+```text
+a < b < c
+```
+
 For example,
 
 ```text

exercises/simple-cipher/README.md

@@ -61,10 +61,7 @@ substitution cipher a little more fault tolerant by providing a source
 of randomness and ensuring that the key contains only lowercase letters.
 
 If someone doesn't submit a key at all, generate a truly random key of
-at least 100 characters in length.
-
-If the key submitted is not composed only of lowercase letters, your
-solution should handle the error in a language-appropriate way.
+at least 100 alphanumeric characters in length.
 
 ## Extensions
 

exercises/two-fer/README.md

@@ -2,15 +2,28 @@
 
 `Two-fer` or `2-fer` is short for two for one. One for you and one for me.
 
+Given a name, return a string with the message:
+
 ```text
-"One for X, one for me."
+One for X, one for me.
 ```
 
-When X is a name or "you".
+Where X is the given name.
+
+However, if the name is missing, return the string:
+
+```text
+One for you, one for me.
+```
 
-If the given name is "Alice", the result should be "One for Alice, one for me."
-If no name is given, the result should be "One for you, one for me."
+Here are some examples:
 
+|Name    | String to return 
+|:------:|:-----------------: 
+|Alice   | One for Alice, one for me. 
+|Bob     | One for Bob, one for me.
+|        | One for you, one for me.
+|Zaphod  | One for Zaphod, one for me.
 
 ## Running the tests