Improve advice_api doc format

Make it clearer what type each argument is expected to be.