Hi. Le mer. 18 févr. 2026 à 13:03, elharo (via GitHub) <[email protected]> a écrit : > > > elharo commented on PR #1599: > URL: https://github.com/apache/commons-lang/pull/1599#issuecomment-3920440177 > > > -1: Sentences end in a period. This matters even more when there is more > than one sentence in a description. The first sentence ends in a period but > the second wouldn't? That makes no sense and looks like a typos to boot. This > is the convention I've been using all over Commons. > > Sentences end in a period. Sentence fragments do not end in a period. >
This Javadoc convention never made sense to me: Sentence fragments are sometimes sufficient, but they could always be replaced by a complete sentence (which should thus end with a period). I can't imagine that the intention was to spare a single "." character (?). If so, it would have been more sensible to suggest dropping the "the" in front of the fragment for "@param" tags... [Personally, I find it useless (and ugly).] Regards, Gilles
