fix html and add notes