some documentation notes.