Update function templates (#856)

* simple-cipher

* allergies

* anagram

* armstrong-numbers

* atbash-cipher

* change

* collatz-conjecture

* connect

* dart

* diamond

* difference-of-squares

* dnd-character

* dominoes

* eliuds-eggs

* gigasecond

* high-scores

* isbn

* isogram

* leap

* list-ops

* luhn

* matching-brackets

* matrix

* pangram

* pig-latin

* pythagorean-triplets

* resistor-color

* resistor-color-duo

* reverse-string

* robot-simulator

* roman-numerals

* run-length-encoding

* saddle-points

* scrabble-score

* space-age

* spiral-matrix

* square-root

* sublist

* sum-of-multiples

* transpose

* triangle

* two-fer

* word-count

* wordy

* yacht

* break into multiple lines && misc fixes

Author: tasxatzial

exercises/practice/allergies/src/allergies.clj

@@ -1,13 +1,14 @@
 (ns allergies)
 
 (defn allergic-to?
-  "Returns true if the score indicates an allergy to the allergen; otherwise, returns false"
+  "Returns true if the score indicates an allergy to the allergen;
+  otherwise, it returns false."
   [score allergen]
   ;; function body
   )
 
 (defn allergies
-  "Returns all allergens associated with the score"
+  "Returns all allergens associated with the score."
   [score]
   ;; function body
   )

exercises/practice/anagram/src/anagram.clj

@@ -1,5 +1,7 @@
 (ns anagram)
 
-(defn anagrams-for [word prospect-list] ;; <- arglist goes here
-  ;; your code goes here
+(defn anagrams-for
+  "Returns all words from candidates that are anagrams of the given word."
+  [word candidates]
+  ;; function body
 )

exercises/practice/armstrong-numbers/src/armstrong_numbers.clj

@@ -1,7 +1,8 @@
 (ns armstrong-numbers)
 
 (defn armstrong?
-  "Returns true if the given number is an Armstrong number; otherwise, returns false"
+  "Returns true if the given number is an Armstrong number;
+  otherwise, it returns false."
   [num]
   ;; function body
   )

exercises/practice/atbash-cipher/src/atbash_cipher.clj

@@ -1,13 +1,13 @@
 (ns atbash-cipher)
 
 (defn encode
-  "Encodes the given text using the Atbash cipher."
+  "Encodes text using the Atbash cipher."
   [plaintext]
   ;; function body
   )
 
 (defn decode
-  "Decodes the given text using the Atbash cipher."
+  "Decodes text using the Atbash cipher."
   [ciphertext]
   ;; function body
   )

exercises/practice/change/src/change.clj

@@ -1,8 +1,8 @@
 (ns change)
 
 (defn issue
-  "Given an amount to change and a set of coins, it returns the
-  fewest coins such that the sum of their values equals the change"
+  "Given an amount to change and a set of coins, it returns the fewest coins
+  such that the sum of their values equals the change."
   [amount coins]
   ;; function body
   )

exercises/practice/collatz-conjecture/src/collatz_conjecture.clj

@@ -1,8 +1,8 @@
 (ns collatz-conjecture)
 
 (defn collatz
-  "Returns the number of steps it takes to reach 1 according
-  to the rules of the Collatz Conjecture."
+  "Returns the number of steps for num to reach 1
+  according to the Collatz Conjecture."
   [num]
   ;; function body
 )

exercises/practice/connect/src/connect.clj

@@ -3,4 +3,5 @@
 (defn connect-winner
   "Returns the winner of the given connect board."
   [board]
+  ;; function body
   )

exercises/practice/darts/src/darts.clj

@@ -1,7 +1,7 @@
 (ns darts)
 
 (defn score
-  "Calculates the score of a dart throw"
+  "Calculates the score of a dart throw."
   [x y]
   ;; function body
   )

exercises/practice/diamond/src/diamond.clj

@@ -1,7 +1,7 @@
 (ns diamond)
 
 (defn diamond
-  "Returns the diamond shape for a letter."
+  "Returns a diamond shape pattern for the given letter."
   [letter]
   ;; function body
   )

exercises/practice/difference-of-squares/src/difference_of_squares.clj

@@ -1,19 +1,20 @@
 (ns difference-of-squares)
 
 (defn square-of-sum
-  "Returns the square of the sum of the numbers up to the given number"
-  [n]
+  "Returns the square of the sum of the numbers up to N."
+  [N]
   ;; function body
   )
 
 (defn sum-of-squares
-  "Returns the sum of the squares of the numbers up to the given number"
-  [n]
+  "Returns the sum of the squares of the numbers up to N."
+  [N]
   ;; function body
   )
 
 (defn difference
-  "Returns the difference between the square of the sum of numbers up to a given number and the sum of the squares of those numbers"
-  [n]
+  "Returns the difference between the square of the sum
+  and the sum of the squares of the numbers up to N."
+  [N]
   ;; function body
   )