Proof-read Supervisor docs
Merge pull request #2334 from alco/supervisor-doc

Proof-read Supervisor docs