Re: a few coding standards
| From: | Dave | Date: | Wed, 28 Jul 2004 11:41:44 +0000 |
| Subject: | Re: a few coding standards | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969362310@lists.php.net to get a copy of this message | ||
On Wednesday, July 28, 2004, 9:11:44 PM, Nuno wrote:
>> Hello all!
>>
>> Just want to confirm that the following are true as I don't
>> believe these have been made official [yet]:
>>
>> a) No ending period in the reftitle
> agree here
Obviously I agree, after that commit I did fixing the few functions
that didn't conform. :)
>> b) No ending period in the see also
> Why not?
> "See also echo and print."
> The ending period makes sense to me!
This also make sense to me. Unlike the refpurpose, the "see also"
paragraph is exactly that; a paragraph in the body of the text, and
should end in a period like any other sentence.
Consistency between these sorts of things may not be as important as
content, but it does make for a more refined and professional manual.
<snip>
> Nuno
Dave