garydgregory commented on PR #1599: URL: https://github.com/apache/commons-lang/pull/1599#issuecomment-3920479065
It's just simpler to end in a period, whether there is one sentence or two. The subtle differences Oracle tries to make are, IMO, absurd, for example, these examples where 3 out of 4 descripions end in a period: > When writing a phrase, do not capitalize and do not end with a period: > @param x the x-coordinate, measured in pixels > When writing a phrase followed by a sentence, do not capitalize the phrase, but end it with a period to distinguish it > from the start of the next sentence: > @param x the x-coordinate. Measured in pixels. > If you prefer starting with a sentence, capitalize it and end it with a period: > @param x Specifies the x-coordinate, measured in pixels. > When writing multiple sentences, follow normal sentence rules: > @param x Specifies the x-coordinate. Measured in pixels. You can just end in a period, and keep it simple. There is no advantage to having this distinction, especially for non-English-speaking native speakers. There is no "Sentence fragments". -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected]
