a few notes in documentaion