adds some html comment clarifications