Hi,
This is a long standing TODO item. Zeev finally found the time to think about it a bit, and agreed that the Zend API documentation is going to be moved to phpdoc. Here is the relevant excerpt from his mail:
| We're willing to reassign the copyright to the PHP Doc team with | just one condition - we'd like there to be an attribution to | Zend, mentioning that the docs are based on an initial | contribution by Zend Technologies. | | I hope this was worth the wait :)
Now this mail gets publicly archived, and so Zeev can confirm it with a public reply. What do we gain from moving the ZendAPI docs to phpdoc?
- one build system instead of two
- more visibility for people to rewrite / improve on it, being in the recognized phpdoc module
- more opennes (the content is still going to be licensed under the same license as before, which is the same as the license phpdoc uses, but the license holder is going to change from Zend to the PHP Doc team)
- development docs get into the same place (streams development stuff is in phpdoc too)
- technically it is going to be possible for translations to translate the Zend API docs (although it is not advised now) - note that someone from the Russian team even translated some files and committed them to the ZendAPI repository
I propose moving the Zend API docs to phpdoc/en/zendapi, but we need to make up a good folder structure. We need the XML files, but not simpler then Extending_Zend_....xml, and we also need the figures and source examples in some sensible folder structure. I also don't know whether it would be better to move on the CVS server (retaining history), or just copy-add-commit-remove_on_old_file...
Goba