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
