improve formatting and spelling in docs

hirarchy -> hierarchy and change to hopefully avoid putting a long string of dashes into the haddock output like it is here http://hackage.haskell.org/package/Boolean-0.2.1/docs/Data-Boolean-Numbers.html