Updating documentation

Problem/Motivation

Some clean-up of documentation:
- Usage example for 'merge-plugin' causes invalid JSON
- drush commands not mentioned
- known issues.

Steps to reproduce

Read.

Proposed resolution

Write.