Re: CVS <-> Online Manual

From: Date: Mon, 28 Nov 2005 17:17:30 +0000
Subject: Re: CVS <-> Online Manual
References: 1  Groups: php.doc 
Request: Send a blank email to phpdoc+get-969371033@lists.php.net to get a copy of this message
> I've got a few things to say that bug me about building new versions of > the localized manual. I can only speak about the German translation, > because that's where I've done a bit of work lately. > > The online manual at http://de.php.net/<funcname> shows > "Last updated: > Tue, 20 Sep 2005" and as I follow the commit-messages quite a bit has > been done in that time. > > Now I've heard that some days ago Derick started the build process, and > http://doc.php.net/php/de/revcheck.php seems to be up to date, > but the > docs themselves haven't changed. > I may have done something wrong with de/reference/pdo/reference.xml for > example, but even the other changes didn't show up. > > Now the question is: Why is the manual always several months behind, > when the stuff already *is* available. I know that this DocBook stuff > takes ages to process, but would it be too much to at least run it every > 2 weeks? I count 11 commits to de/ in the last 10 days alone, that are > certainly ~15 updated pages. > > I'm sorry if I'm bugging the wrong people, but the doc-de list isn't > really active and I doubt that anyone there can give me details or even > check this update (that should've been completed after a few days..) Run a 'make test' on the German manual. If it runs fine, and you see quite a lot of changes needing attention, bug Derick to build the German translation. If you are unhappy with this situation, try livedocs. The prebuilt one is the easiest to start with. If this software gets production ready, all the changes will be pushed to mirror sites in no time (hours!). We need actively helping people to make this exciting revolution happen :) http://blog.phpdoc.info/archives/18-Pre-Built-Livedocs.html Regards, Gabor Hojtsy

« previous php.doc (#969371033) next »