change note about generated docs to html comment