Minor rewrite of advice API docs