add comment on code to generate docs