Re: svn: /phpdoc/doc-base/trunk/RFC/ coding_standards
| From: | Daniel Convissor | Date: | Sun, 25 Apr 2010 12:45:52 +0000 |
| Subject: | Re: svn: /phpdoc/doc-base/trunk/RFC/ coding_standards | ||
| References: | 1 2 | Groups: | php.doc.cvs |
| Request: | Send a blank email to doc-cvs+get-6454@lists.php.net to get a copy of this message | ||
Hi Hannes:
On Sun, Apr 25, 2010 at 09:58:34AM +0200, Hannes Magnusson wrote:
> On Tue, Apr 20, 2010 at 16:57, Daniel Convissor <danielc@php.net> wrote:
> > danielc ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ? ?Tue, 20 Apr 2010 14:57:25 +0000
> >
> > Modified: phpdoc/doc-base/trunk/RFC/coding_standards
> >
> > -<para>
> > - <example xml:id="foo.example.output">
> > - ?<title>A <function>foo</function> example</title>
> > - ?<programlisting role="php">
> > + <refsect1 role="examples">
> > + ?&reftitle.examples;
> > + ?<example>
>
> Please keep the ID there.
> All our example really should have IDs, otherwise anchor tags wont be
> generated for them which makes it harder to link to and generate
> example listing in the future.
Oh. The method.xml skeleton, and all of the docs I've seen in the wild,
don't have the ID for individual examples, so that seemed like the
standard. Though I now see the function.xml skelton does have it.
Thanks,
--Dan
--
T H E A N A L Y S I S A N D S O L U T I O N S C O M P A N Y
data intensive web and database programming
http://www.AnalysisAndSolutions.com/
4015 7th Ave #4, Brooklyn NY 11232 v: 718-854-0335 f: 718-854-0409