Improve hook_civicrm_merge docs
I found the merge docs confusing I've added
- a clarification that you might not need to use the hook
- added a simple example related to the merging tables using polymorphic relationships.
- wrapped the code comments so they fit in mkdocs' code output.