Re: [PHP-DOC] Documentation and the website

2002-04-16 Thread Colin Viebrock
> 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 > >i

Re: [PHP-DOC] Documentation and the website

2002-04-16 Thread Hartmut Holzgraefe
Colin Viebrock wrote: > Can the documentation folks use release tags like the dev folks do? For > instance, when PHP 4.2.0 is release, make a PHP_4_2_0 branch in CVS for the > docs. [...] just some quick points: - when you do documentation, even for your own extension, you usually do not kno

Re: [PHP-DOC] Documentation and the website

2002-04-15 Thread Gabor Hojtsy
> In an IRC chat with Derrick, it was brought up that getting translators to > work with CVS branches could possibly make my idea undoable (i.e., it's > asking too much of people to learn how to use branches properly). > Personally, I disagree, but that can be discussed here as well. An itelligen

Re: [PHP-DOC] Documentation and the website

2002-04-15 Thread Colin Viebrock
> Something like this problem was discussed on our meeting at Stuttgart. > We came up with the idea of including a "Changelog" on all function > pages where it is needed. We can't freeze the docs for specific PHP > versions as we often discover undocumented features let's say, from > PHP 4.0.0...

Re: [PHP-DOC] Documentation and the website

2002-04-15 Thread Gabor Hojtsy
> It seems to be that a lot of the time, the documentation on the website is > out of step with the latest release of PHP. In almost all of these cases, > PHP is at version X, and the online docs are describing version X+1, or the > CVS version. > > Case in point: the DOMXML extension is now much

[PHP-DOC] Documentation and the website

2002-04-15 Thread Colin Viebrock
I'm not really involved in the documentation side of things, so take what I say with a grain of salt. It seems to be that a lot of the time, the documentation on the website is out of step with the latest release of PHP. In almost all of these cases, PHP is at version X, and the online docs are