adding documentation and notes.