Re: Documentation and the website

From: 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

« previous php.doc (#969344457) next »