added notes
updated docs