Re: Re: weekly doc builds

On 1 September 2014 14:52, Richard Quadling <rquadling@gmail.com> wrote: > > > > On 29 August 2014 17:34, Ferenc Kovacs <tyra3l@gmail.com> wrote: >> >> >> 2014.08.29. 18:23 ezt írta ("Peter Cowburn" <petercowburn@gmail.com>): >> >> >> > >> > >> > >> > >> > On 29 August 2014 17:11, Hannes Magnusson <hannes.magnusson@gmail.com> >> > wrote: >> >> >> >> On Fri, Aug 29, 2014 at 9:05 AM, Ferenc Kovacs <tyra3l@gmail.com> >> >> wrote: >> >> > Hi, >> >> > >> >> > yesterday I had to rebuild the docs on rsync.php.net so we got some >> >> > php >> >> > 5.6.0 related doc fixed out sooner than the weekly build today, and >> >> > I'm just >> >> > wondering if there is still a reason to only rebuild the >> >> > documentation on >> >> > once a week. >> >> > a successful build seems to take about 40 minutes, and we currently >> >> > have 11 >> >> > active languages, so the full rebuild (when all langs can be built >> >> > successfuly, yesterday we had 6 broken lang, pt_BR, zh, de, it, ru, >> >> > tr) >> >> > takes about 7.3 hours. >> >> > >> >> > and here comes my question: is there any reason why should we just >> >> > rebuild >> >> > the docs every day? >> >> > http://docs.php.net/ seems to be able to >> >> > handle that just fine for >> >> > years >> >> > now. >> >> >> >> >> >> >> >> The rsync server isn't exactly state-of-the-art, also pushing out gb >> >> of updates every day will amplify the bandwidth issue it already has. >> > >> > >> > Wasn't there also a plan to move the actual building of the docs off of >> > the rsync box? We could stick it on a nice, beefy docs build server... >> > assuming there's such a machine just lying around doing nothing. >> >> Good idea, we could even use the result of the build from the docs.php.net >> server, that would even end up saving time and processing power. > > > Considering we also need a Windows machine to build the CHMs, is it worth > (and I truly feel your collective shivers) that the Doc building box be > windows? That way, only 1 box to build all the doxs? I say this knowing very little of the subject matter but... is there really no way to build the CHMs on *nix? I'd be happy to look into this if it's simply a case of someone putting the time in to make it work. Looking round the net I can find a few unofficial but comprehensive documents detailing the file format. Is there a blocker to this other than simply not having a tool for the job at present? > -- > Richard Quadling >