add some clarifying comments to html