Update function templates

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
   )

exercises/practice/dnd-character/src/dnd_character.clj

@@ -1,19 +1,19 @@
 (ns dnd-character)
 
 (defn score-modifier
-  "Calculates a score's modifier"
+  "Calculates the modifier of the given score."
   [score]
   ;; function body
   )
 
 (defn rand-ability
-  "Generates a random ability"
+  "Generates a random ability."
   []
   ;; function body
   )
 
 (defn rand-character
-  "Generates a random character"
+  "Generates a random character."
   []
   ;; function body
   )

exercises/practice/dominoes/src/dominoes.clj

@@ -1,7 +1,8 @@
 (ns dominoes)
 
 (defn can-chain?
-  "Given a collection of dominoes, it returns true if they can be arranged into a chain; otherwise, it returns false"
+  "Given a collection of dominoes, it returns true if they
+  can be arranged into a chain; otherwise, it returns false."
   [dominoes]
   ;; function body
-  )
+  )

exercises/practice/eliuds-eggs/src/eliuds_eggs.clj

@@ -2,6 +2,6 @@
 
 (defn egg-count
   "Returns the number of 1 bits in the binary representation of the given number."
-  [number]
+  [num]
   ;; function body
   )

exercises/practice/gigasecond/src/gigasecond.clj

@@ -1,7 +1,7 @@
 (ns gigasecond)
 
 (defn from
-  "Determines the date one gigasecond after the given date"
+  "Determines the date one gigasecond after the given date."
   [date]
   ;; function body
   )

exercises/practice/high-scores/src/high_scores.clj

@@ -1,25 +1,25 @@
 (ns high-scores)
 
 (defn scores
-  "Returns all scores"
+  "Returns all scores."
   [scores]
   ;; function body
   )
 
 (defn latest
-  "Returns the latest score"
+  "Returns the latest score."
   [scores]
   ;; function body
   )
 
 (defn personal-best
-  "Returns the top (highest) score"
+  "Returns the top (highest) score."
   [scores]
   ;; function body
   )
 
 (defn personal-top-three
-  "Returns the top three scores"
+  "Returns the top three scores."
   [scores]
   ;; function body
   )

exercises/practice/isbn-verifier/src/isbn_verifier.clj

@@ -1,7 +1,8 @@
 (ns isbn-verifier)
 
 (defn isbn?
-  "Returns true if the given isbn is valid; otherwise, returns false"
+  "Returns true if the given isbn is valid;
+  otherwise, it returns false."
   [isbn]
   ;; function body
   )

exercises/practice/isogram/src/isogram.clj

@@ -1,7 +1,8 @@
 (ns isogram)
 
 (defn isogram?
-  "Returns true if the given string is an isogram; otherwise, returns false"
+  "Returns true if the given string is an isogram;
+  otherwise, it returns false."
   [s]
   ;; function body
   )

exercises/practice/largest-series-product/src/largest_series_product.clj

@@ -1,7 +1,8 @@
 (ns largest-series-product)
 
 (defn largest-product
-  "Returns the largest product of any consecutive digits of length span in the string s."
+  "Returns the largest product of any consecutive digits of length span
+  in the string s."
   [span s]
   ;; function body
   )

exercises/practice/leap/src/leap.clj

@@ -1,7 +1,8 @@
 (ns leap)
 
 (defn leap-year?
-  "Determine if a year is a leap year"
+  "Returns true if the given year is a leap year;
+  otherwise, it returns false."
   [year]
   ;; function body
   )

exercises/practice/list-ops/src/list_ops.clj

@@ -1,49 +1,56 @@
 (ns list-ops)
 
 (defn append 
-  "Given two vectors, it adds all the items in the second vector to the end of the first vector"
+  "Given two vectors, it adds all the items in the second vector to the
+  end of the first vector."
   [coll1 coll2]
   ;; function body
   )
 
 (defn concatenate 
-  "Given a vector of vectors, it combines all the vectors into one flattened vector"
+  "Given a vector of vectors, it combines all the vectors into one flattened
+  vector."
   [colls]
   ;; function body
   )
 
 (defn select-if
-  "Given a predicate and a vector, it returns the vector of all items for which predicate(item) is true"
+  "Given a predicate and a vector, it returns the vector of all items for
+  which predicate(item) is true."
   [pred coll]
   ;; function body
   )
 
 (defn length 
-  "Given a vector, it returns the number of items within it"
+  "Given a vector, it returns the number of items within it."
   [coll]
   ;; function body
   )
 
 (defn apply-to-each 
-  "Given a function and a vector, it returns the vector of the results of applying function(item) on all items"
+  "Given a function and a vector, it returns the vector of the results of
+  applying function(item) on all items."
   [f coll]
   ;; function body
   )
 
 (defn foldl 
-  "Given a function, a vector, and initial accumulator, it folds (reduces) each item into the accumulator from the left"
+  "Given a function, a vector, and initial accumulator, it folds (reduces)
+  each item into the accumulator from the left."
   [f coll acc]
   ;; function body
   )
 
 (defn foldr
-  "Given a function, a vector, and an initial accumulator, it folds (reduces) each item into the accumulator from the right"
+  "Given a function, a vector, and an initial accumulator, it folds (reduces)
+  each item into the accumulator from the right."
   [f coll acc]
   ;; function body
   )
 
 (defn reverse-order 
-  "Given a vector, it returns a vector with all the original items, but in reverse order"
+  "Given a vector, it returns a vector with all the original items, but in
+  reverse order."
   [coll]
   ;; function body
   )

exercises/practice/luhn/src/luhn.clj

@@ -1,8 +1,8 @@
 (ns luhn)
 
 (defn valid?
-  "Returns true if the given number is valid according
-  to the luhn algorithm; otherwise, returns false."
+  "Returns true if the given string is a valid number;
+  otherwise, it returns false."
   [s]
   ;; function body
   )

exercises/practice/matching-brackets/src/matching_brackets.clj

@@ -1,7 +1,8 @@
 (ns matching-brackets)
 
 (defn valid?
-  "Returns true if the given string has properly matched brackets; otherwise, returns false."
+  "Returns true if the given string has properly matched brackets;
+  otherwise, it returns false."
   [s]
   ;; function body
   )

exercises/practice/matrix/src/matrix.clj

@@ -1,13 +1,13 @@
 (ns matrix)
 
 (defn get-row
-  "Returns the i-th row of the matrix s"
-  [s i]
+  "Returns the i-th row of the matrix."
+  [matrix i]
   ;; function body
   )
 
 (defn get-column
-  "Returns the i-th column of the matrix s"
-  [s i]
+  "Returns the i-th column of the matrix."
+  [matrix i]
   ;; function body
   )

exercises/practice/pangram/src/pangram.clj

@@ -1,7 +1,8 @@
 (ns pangram)
 
 (defn pangram?
-  "Returns true if the given string is a pangram; otherwise, returns false"
+  "Returns true if the given string is a pangram;
+  otherwise, it returns false."
   [s]
   ;; function body
   )

exercises/practice/pig-latin/src/pig_latin.clj

@@ -1,7 +1,7 @@
 (ns pig-latin)
 
 (defn translate
-  "Translates phrase from English to Pig Latin"
+  "Translates phrase from English to Pig Latin."
   [phrase]
   ;; function body
   )

exercises/practice/pythagorean-triplet/src/pythagorean_triplet.clj

@@ -1,7 +1,8 @@
 (ns pythagorean-triplet)
 
 (defn find-pythagorean-triplets
-  "Given an integer N, it returns all Pythagorean triplets for which a + b + c = N"
+  "Given an integer N, it returns all Pythagorean triplets
+  for which a + b + c = N."
   [N]
   ;; function body
   )

exercises/practice/resistor-color-duo/src/resistor_color_duo.clj

@@ -1,7 +1,7 @@
 (ns resistor-color-duo)
 
 (defn resistor-value
-  "Returns the resistor value based on the given colors"
+  "Returns the resistor value based on the given colors."
   [colors]
   ;; function body
   )

exercises/practice/resistor-color/src/resistor_color.clj

@@ -5,7 +5,7 @@
   )
 
 (defn color-code
-  "Returns the numerical value associated with the given color"
+  "Returns the numerical value associated with the given color."
   [color]
   ;; function body
   )