   @doc """
   Creates a map.
 
-  Maps are key-value stores where keys are compared using
+  Maps are key-value stores where keys are compared 
   using the match operator (`===`). Maps can be created with
   the `%{}` special form where keys are associated via `=>`:
 
       %{ 1 => 2 }
 
   Maps also support the keyword notation, as other special forms,
-  as long as they are appended to the remaining arguments:
+  as long as they are at the end of the argument list:
 
       %{ hello: :world, with: :keywords }
       %{ :hello => :world, with: :keywords }

  as a call to the special form `:{}`.

  Conveniences for manipulating tuples can be found in the
  `Tuple` module. Some functions for working with tuple are
  also available in `Kernel`, namely `Kernel.elem/2`,
  `Kernel.set_elem/3` and `Kernel.tuple_size/1`.


  default values for keys, tags to be used in polymorphic
  dispatches and compile time assertions.

  To define a struct, you just need to implement the `__struct__/0`
  function in a module:

      defmodule User do
