Some User Guide Updates

Replaces https://github.com/cylc/cylc/pull/1057
(branch rebased to master).

See comments https://github.com/cylc/cylc/pull/1057#issue-39578053