added more notes to doc