adds some html comment clarifications
merged changes