Gabor Hojtsy wrote: > The visual editor idea is aimed at solving the complexity of DocBook > for authors and translators. But currently it is a more critical > problem, that new updates take months to get on to the website (which > does decrease the motivation of translators).
+1 The manuals are being compiled with more frequency, but I still feel lack of the automatic compilation, revcheck on-line... > Implementing the build system with PHP (either with Phing or with a > custom solution) might need some work, but it would have a benefit on > the other side of lowering the barrier of contributions for the > documentation. The documentation SDK idea from Jan Fabry also helps in > this case, packaging only the needed cygwin tools without the bunch of > stuff not needed... For each problem, a different solution. To lower the barrier of contributions a solution as proposed by nuno may be the best: Some few sites have the current system WITH the on-line editor, that it is capable to execute tests, compilations, etc. It solves the problem of much people to have to install the entire system, all time, and still allows to small contibuições and great alterations, even though on-line. A solution similar to the one of the Nuno and currently in use: http://www.java2.kit.net/ http://www.hwn.com.br/pej/tij2pej/PEJ3.htm It's not very pretty, but it is an idea of that it can be made. (I am thinking about showing the pure XML and using the cvs client with some hacks in CVS directory, one per WIP) > The idea is to make the build system useable (and hopefully unified) > for all projects. Our needs are converging, since the PHP > documentation just needs to accomodate OO docs, long time after the > PHP-GTK and PEAR docs needed that. Which the great problem with OO after all? Render, search, filenames? http://www.docbook.org/tdg/en/html/classsynopsis.html > So the needs are increasingly the > same, and we would like to keep the door open for all contributors to > put effort in any PHP documentation project they like to add their > freetime to. This means keeping the build system simple and keeping > the vairous build systems as close as possible. > > Goba []s André Æ
