Re: Fwd: [DOC-CVS] svn: /phpdoc/en/trunk/reference/sca/ examples.xml

On 10 June 2011 13:47, Hannes Magnusson <hannes.magnusson@gmail.com> wrote: > LOL. Took me a while to notice it was a forward. Looked like you were > a first class schizophrenic > > On Fri, Jun 10, 2011 at 14:11, Richard Quadling <rquadling@gmail.com> wrote: >> ---------- Forwarded message ---------- >> From: Yannick Torrès <yannick.torres@gmail.com> >> Date: 10 June 2011 13:08 >> Subject: Re: [DOC-CVS] svn: /phpdoc/en/trunk/reference/sca/ examples.xml >> To: RQuadling@gmail.com >> Cc: doc-cvs@lists.php.net >> >> >> Hi Richard, >> >> 2011/6/10 Richard Quadling <rquadling@gmail.com> >>> >>> On 10 June 2011 10:01, Yannick Torres <yannick@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" ? > > > Its an utterly useless change which just causes issues. > > If it finds its way to the 'best practice', people will start changing > this all over the place, and commenting on it when people use single > quotes. > > There is nothing to gain here. > > -Hannes > OK. -- Richard Quadling Twitter : EE : Zend : PHPDoc @RQuadling : e-e.com/M_248814.html : bit.ly/9O8vFY : bit.ly/lFnVea