Minor rewrite of advice API docs
Merge pull request #133 from flightjs/docs/advice-api

Minor rewrite of advice API docs