Add documentation for the merge function

[Eruant]

Using the documentation for curry as an example. Provide documentation on three key areas 1) How to use the merge function 1) How it might be used in the real world 1) How the underlying code works