updates for some documentation/notes