Add comments

should this be left out? we have a failure path for html, so perhaps a success path would be useful as well :)