Improve Haddock comments for enum

[joel-bach]

The enum types are not very self-explanatory. More information regarding the generated types would help understand it.

• Add comments for the Typed and Other cases and their usage
• Add comments for string literals to show what value the cases represent