Minor rewrite of advice API docs

Ref #131 

Should `.withAdvice` be documented here too?