added notes to documentation