RE: [PHP-DEV] RFC: Move phpng to master

> -----Original Message----- > From: Stas Malyshev [mailto:smalyshev@sugarcrm.com] > Sent: Wednesday, July 23, 2014 8:00 AM > To: Zeev Suraski; PHP internals > Subject: Re: [PHP-DEV] RFC: Move phpng to master > > I think before we do that we need to do much better documentation around > the changes in the engine. I know that in the past we followed the "code > is > documentation" pattern, but the code there becomes more and more dense, > with macros upon macros upon macros, and myriads of micro-optimizations > which make sense only in specific context. Absent that context and > documentation, understanding what is going on becomes much harder and so > becomes dealing with that code. Some of the changes right now are > partially > documented in https://wiki.php.net/phpng-int, some (like > parameter parsing > API) not documented at all. Given that, I'm not even sure I understand > what > phpng is right now - as I didn't have time to parse every commit during > active > development. So it would be nice to have some internal docs if we want > people to form an informed opinion about what is being proposed. > > And, of course, the porting guide for extension authors is another > required > part. I know the phpng team did great work porting the extensions, but > people > would need to support them and add the new ones, so it is a must. As Dmitry mentioned, this is something we're going to work on (with primary focus around the porting guide, and secondary focus on extending the internals document). Zeev