mvriel/Docblox — comment on commit 589ebad154ba881b6998425d81eaf677023a5b3c
File: docs/PSR.md line 526
By GaryJones:

No, my intention was to question whether it should look like a grammatically correct sentence or not.

Personally, since the presentation of the `@param` descriptions, either in IDE tooltips, or DocBlox et al, tends to be in a table then it makes sense to have it as a sentence. A description which is naturally two sentences would have a full stop and a capital letter between the two, so why not at the start and end as well?

I also find that having a capital letter at the start of the sentence is an easier visual delimiter against the (almost always) lowercase string of the argument name, when scanning quickly.

Can you point to the part of the PEAR standard that explicitly mentions that `@param' descriptions (and for that matter `@global`, `@return` and other tags) should not start with a capital letter and end with a full stop?