I personally find it more aesthetic and much more expedient to use a standard style guide that many people are already familiar with (more or less, often less).
Making up a new style guide is a waste of breath and subject to minor aesthetic quibbles like whether to use a phrase. The Sun guides are generally very good and where they have minor issues, the virtue of being an accepted standard trumps everything else. For one thing, we can do something productive in the code rather than argue about grammar and punctuation. On Wed, Jan 12, 2011 at 2:32 PM, Gilles Sadowski < gil...@harfang.homelinux.org> wrote: > I find it more esthetic to apply *one* set of rules and not one set here > and another there; the above examples look really messy... > So, for the "@param" tag, I prefer this set: > * Do not use the article "the". > * Always capitalize. > * Write full sentences, with punctuation. >
