---------- Forwarded message ----------
From: Yannick Torrès <yannick.tor...@gmail.com>
Date: 10 June 2011 13:08
Subject: Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/sca/ examples.xml
To: rquadl...@gmail.com
Cc: doc-...@lists.php.net


Hi Richard,

2011/6/10 Richard Quadling <rquadl...@gmail.com>
>
> On 10 June 2011 10:01, Yannick Torres <yann...@php.net> wrote:
> > -   <link linkend='ref.sdo'>the SDO pages</link>.
> > +   <link linkend='ref.sdo'>the SDO pages</link>).
>
> How stringent should we be regarding the use of single quotes for attributes?
>
> A quick check on phpdoc/en, and there are 359 linkend=' in 48 files
> out of the 11,351 searched.
>
> Compared to linkend=" which come to 6,163 matches in 1,815 files.
>
> Obviously it isn't having an impact at the moment as the documentation
> is built just fine and the links work.
>
> But, considering whitespace issues are jumped on quite heavily, should
> other things be just as policed?

I'm agree with you about the single quotes usages : event if there
isn't an impact regardless the documentation build, we shoud use
double quote for all of this.

Perhaps we could add this into our "best pratice" ?

Best,
Yannick


-- 
Richard Quadling
Twitter : EE : Zend : PHPDoc
@RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY : bit.ly/lFnVea

Reply via email to