Re: cvs: phpdoc / Makefile.in
| From: | Philip Olson | Date: | Fri, 16 May 2003 18:51:08 +0000 |
| Subject: | Re: cvs: phpdoc / Makefile.in | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969353547@lists.php.net to get a copy of this message | ||
> > > 1) We don't reset the Example numbering for each function name. (I
> > > fixed this.)
> >
> > We agreed that this is not a problem, maybe even an advantage. One can
> > refer to a specific example number (but it will change with every build,
> > so this should not be relied on). As far as I can see it is not our main
> > focus to make the XSL output exactly the same as the DSSSL one. Anytime
> > we can improve things, we'd better to that. This was considered to be
> > sort of an improvement.
>
> Hum... I don't think I really agree that this is sort of an
> improvement. If you refer to Example 2 for array_merge() and it's
> switched to Example 3, then it's a little confusing, but you're still
> on the page physical HTML page. But, if Example 143 moves from
> array_merge() to array_merge_recursive() then that's really
> confusing.
>
> Since we update the docs on a frequent basis that means all the
> Examples won't necessarily stay constant for more than a few
> days. That kind of defeats the purpose of letting people refer to them
> easily. IMHO.
This is a good point, we should go back to the old method
unless something else is figured. I was also for the new
"feature" but have been convinced otherwise.
Regards,
Philip