Hi Maciej, On Mon, Feb 9, 2015 at 1:48 PM, Maciej Sobaczewski <so...@php.net> wrote:
> I'm totally aware that those files are tend to be more up-to-date thanks > to placing them directly where core developers work. However, we have wiki > pages for internals stuff, so why not move it to the manual and provide > better "Zend Hacker's Guide"? There were some complaints about its > incompleteness and creation of Zend Engine 3 is a great opportunity to fix > it. Manual build system is awesome, but writing manual is pain indeed because it's sgml. For new release, updating the manual to current state would be difficult. We have missing items even in text files in source. I agree with you in general, but it's just not feasible it seems. I also have number of doc bugs that are not fixed yet... I had to spent few hours to know/get used to ZE3 API. However, thanks to folks who ported most of modules, I didn't had much problem. ZE3 API is more developer friendly than ZE2 as well. Basic stuff should be in source. IMO. Perhaps, we should use only the Wiki for additional internal stuff from now on. Keeping in sync wiki and manual seems to hard, but nobody will prevent make this effort if you would like to. ZE3 manual section is nice to have, but it may be better to use only wiki until we release PHP7. Regards, -- Yasuo Ohgaki yohg...@ohgaki.net
