add notes from jvrousseau
update html