minor fixes in Maps (#77)

* minor fixes in Maps
* added printed output as comment
* additional comment, comment formatting
* additional comment
* added another list example
* Fix foldRight code quote
* In foldRightFunctionTraversables explanation, foldRight is not quoted correctly and the rest of phrase is rendered as code.
* minor fixes in Maps

Author: hellrich

src/main/scala/stdlib/Maps.scala

@@ -24,7 +24,7 @@ object Maps extends FlatSpec with Matchers with org.scalaexercises.definitions.S
     myMap.size should be(res0)
   }
 
-  /** Maps contain distinct pairings:
+  /** Maps do not contain multiple identical pairs:
     */
   def distinctPairingsMaps(res0: Int) {
     val myMap = Map("MI" → "Michigan", "OH" → "Ohio", "WI" → "Wisconsin", "MI" → "Michigan")
@@ -50,6 +50,15 @@ object Maps extends FlatSpec with Matchers with org.scalaexercises.definitions.S
 
     val lastElement = mapValues.last
     lastElement should be(res2) //Failed presumption: The order in maps is not guaranteed
+
+  }
+
+    /** Maps may be accessed:
+    */
+  def mayBeAccessedMaps(res0: String, res1: String) {
+    val myMap = Map("MI" → "Michigan", "OH" → "Ohio", "WI" → "Wisconsin", "IA" → "Iowa")
+    myMap("MI") should be(res0)
+    myMap("IA") should be(res1)
   }
 
   /** Maps insertion with duplicate key updates previous entry with subsequent value:
@@ -70,14 +79,6 @@ object Maps extends FlatSpec with Matchers with org.scalaexercises.definitions.S
     myMap(49931) should be(res1)
   }
 
-  /** Maps may be accessed:
-    */
-  def mayBeAccessedMaps(res0: String, res1: String) {
-    val myMap = Map("MI" → "Michigan", "OH" → "Ohio", "WI" → "Wisconsin", "IA" → "Iowa")
-    myMap("MI") should be(res0)
-    myMap("IA") should be(res1)
-  }
-
   /** If a nonexistent map key is requested using `myMap(missingKey)`, a `NoSuchElementException` will be thrown.
     * Default values may be provided using either `getOrElse` or `withDefaultValue` for the entire map:
     */

src/test/scala/stdlib/MapsSpec.scala

@@ -43,29 +43,29 @@ class MapsSpec extends Spec with Checkers {
     )
   }
 
-  def `duplicate keys` = {
+  def `map key access` = {
     check(
       Test.testSuccess(
-        Maps.duplicatedKeyInsertionMaps _,
-        3 :: "Meechigan" :: HNil
+        Maps.mayBeAccessedMaps _,
+        "Michigan" :: "Iowa" :: HNil
       )
     )
   }
 
-  def `mixed key types` = {
+  def `duplicate keys` = {
     check(
       Test.testSuccess(
-        Maps.mixedTypeKeysMaps _,
-        "MI" :: "MI" :: HNil
+        Maps.duplicatedKeyInsertionMaps _,
+        3 :: "Meechigan" :: HNil
       )
     )
   }
 
-  def `map key access` = {
+  def `mixed key types` = {
     check(
       Test.testSuccess(
-        Maps.mayBeAccessedMaps _,
-        "Michigan" :: "Iowa" :: HNil
+        Maps.mixedTypeKeysMaps _,
+        "MI" :: "MI" :: HNil
       )
     )
   }