documentation - second draft + word_with_dot corrected