Re: Documentation and the website
| From: | Colin Viebrock | Date: | Tue, 16 Apr 2002 14:52:16 +0000 |
| Subject: | Re: Documentation and the website | ||
| References: | 1 2 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969344457@lists.php.net to get a copy of this message | ||
> just some quick points:
>
> - when you do documentation, even for your own extension,
> you usually do not know in advance which version you stuff
> will be in
>
> it is hard to decide where to set the tag in the doc branch
> unless you have your code and docs really in sync
>
> it is even harder if you write documentation for some
> extension where the author doesn't or didn't
>
> you can't just say "today's CVS is branch xyz", you
> have to do this extension by extension, sometimes
> even function by function
Hmm ... I understand. But remember: people would almost always be
committing their changes/additions to the HEAD branch. It's only when a new
version of PHP is released that someone would need to start a new branch and
make sure things are copasetic between the docs and the source (not a fun
job, to be sure).
> - for the translations this would be a complete nightmare
Agreed. :)
- Colin