rose documentation: update following feedback
rose documentation: tidy
rose documentation: fix FAM
rose documentation: update cylc references
rose documentation: fix ROSE_TASK_LOG_ROOT
rose documentation: improve example format
Merge pull request #689 from benfitzpatrick/doc.suite-feedback

rose documentation: update following feedback