DOC: Add example to Table.merge

Quite a nice one if you ask me.
DOC: Fix problems in the docs

Thanks @teravest & @josenavas
Merge pull request #423 from ElDeveloper/merge-docs

DOC: Add example to Table.merge