added notes to markup