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

Reply via email to