add documentation link and update punctuation