Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:76109
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.219.41 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <CAH-PCH4e3bOuhAW_efcws7p2XUPA_Uy7dVCs8y8UOvnhMzReAA@mail.gmail.com>
References: <CABBJUpdLqn_gfUbBUAd=WzzEbBCvuU9ZziNgbNSCbVPRrGSAzw@mail.gmail.com>
	<CAH-PCH7vLV0To4VGj4HSoTG6wxTgBY+R6BJrtHjCjcDR3oCrRw@mail.gmail.com>
	<53D213D0.7030208@gmail.com>
	<CAPgLKiit3uRpU8DrQBT09oJeY-FaFXPsHr=tnVEmiNsWWfBF3g@mail.gmail.com>
	<CAH-PCH4e3bOuhAW_efcws7p2XUPA_Uy7dVCs8y8UOvnhMzReAA@mail.gmail.com>
Date: Fri, 25 Jul 2014 12:12:43 +0200
Message-ID: <CAF+90c-XCjTgue-XraSwTN_yE0VWNCiq3qq3is3hBbat1KdBCw@mail.gmail.com>
To: Ferenc Kovacs <tyra3l@gmail.com>
Cc: Zeev Suraski <zeev@zend.com>, Jocelyn Fournier <jocelyn.fournier@gmail.com>, 
	Laruence <laruence@php.net>, PHP Internals <internals@lists.php.net>
Content-Type: multipart/alternative; boundary=089e011847a266a7b404ff01d095
Subject: Re: [PHP-DEV] About PHP NG "document lacking" argument
From: nikita.ppv@gmail.com (Nikita Popov)

--089e011847a266a7b404ff01d095
Content-Type: text/plain; charset=UTF-8

On Fri, Jul 25, 2014 at 11:48 AM, Ferenc Kovacs <tyra3l@gmail.com> wrote:

> On Fri, Jul 25, 2014 at 11:41 AM, Zeev Suraski <zeev@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

--089e011847a266a7b404ff01d095--