Hi,
I'm not a native of english, so sometimes it is rather hard for me to get an idea from threads in this maillist where PHPDOC goes. Is there any status page on the process?
Nope.
Page, which like @PHP Documentation HOWTO@ can answer on the following questions: What is so bad in current documentation process?
I would repeat the question :) What make you think there is something bad? There are probably things badly done, but I am unable to just pick one point and say it is bad.
What are you trying to accomplish?
Improve the manual daily with some ocassional bigger steps.
What will be "livedocs", "docweb", "documentation tools"?
Livedocs is supposed to be the documentation display tool for phpdoc. Livedocs is planned to be set up on all mirror sites (automatically, given that sqlite setup will be available on mirrors). Then it will be used instead of the pregenerated DSSSL sheets to display manual pages. Additionaly to this, livedocs is a good tool for phpdoc authors and translators to see their changes in HTML form quickly.
Docweb is supposed to be an all-in-one site for all php.net documentation groups to host documentation tools, which help documentation authors, editors and translators in their daily work. The tools range from revision checks to manual<->php source consistency reports.
What are the differences between them?
This is answered above.
Is there any roadmap and requirements specifications for them?
Nope. It is not possible in an open project this small scale. The taken steps are always discussed on the mailing lists and on IRC.
I'd like to contribute and just don't want my efforts to be wasted.
So then discuss your ideas and your suggested contributions.
Also there are some talks about implementing proprietary PHPDOC DTD as DocBook have some limitations or something? Is there a page describing all these problems?
phpdoc/RFC/reference_grouping explains the problem. a different DTD was choosen, since that paper was written, see phpdoc/dtds/phpbook.dtd
Current version of DocBook DTD at PHPDOC is 4.1.2. Latest from OASIS is 4.2. Why PHPDOC stuck with 4.1.2? What changes were made to DTD 4.2 and which ones from them PHPDOC can take advantage of? http://www.oasis-open.org/docbook/specs/cs-docbook-docbook-4.2.html#docbook
If someone has time to look into this, I would be happy to see the report.
Goba
