On Fri, Jul 25, 2014 at 12:12 PM, Nikita Popov <nikita....@gmail.com> wrote:
> On Fri, Jul 25, 2014 at 11:48 AM, Ferenc Kovacs <tyr...@gmail.com> wrote: > >> On Fri, Jul 25, 2014 at 11:41 AM, Zeev Suraski <z...@zend.com> wrote: >> >> > Jocelyn, >> > >> > I think that a good migration guide is what we need here, and as Dmitry >> > and Ferenc said, much progress has been made there. >> > >> > I think we'd all welcome a new edition of the Sara book, but it happens >> > that the main people who work on PHP internals aren't exactly the book >> > authoring types... We'd need others to step in and contribute, perhaps >> > turn that migration doc into something better. >> > >> >> I really liked what Julien, Anthony and Nikita did with >> http://www.phpinternalsbook.com/ I think it would be pretty awesome if we >> could have talented people like them continue working on documenting the >> current and upcoming internal "api" (preferably under the php.net >> umbrella, >> but ofc. it is their decision as the content creators). >> > > I assume that we'll update our content to use the APIs implemented in PHP > next, or rather have a separate version using those APIs. But doing that > kind of work only makes sense once PHP next is released or at least close > to a release. Especially given the complaints of some parties regarding the > current API, I expect that it may still undergo non-trivial changes before > we get to a release. > > For now I think that the migration guide that is currently in progress, > should be sufficient for extension authors familiar with the current API to > make their extensions phpng compatible. Documentation targeting new > extension authors (like sara's book or ours) is not critical at this time > and writing it now is not worthwhile, because the API is not frozen. > > Nikita > absolutely! -- Ferenc Kovács @Tyr43l - http://tyrael.hu
