most/all of these punctuation changes are not required.

If it's not a sentence ("@return boolean Success" is not a sentence) it doesn't need a ".".