Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:76110
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.192.46 as permitted sender)
MIME-Version: 1.0
In-Reply-To: <CAF+90c-XCjTgue-XraSwTN_yE0VWNCiq3qq3is3hBbat1KdBCw@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>
	<CAF+90c-XCjTgue-XraSwTN_yE0VWNCiq3qq3is3hBbat1KdBCw@mail.gmail.com>
Date: Fri, 25 Jul 2014 12:15:49 +0200
Message-ID: <CAH-PCH7-j=UyD9zK20fpJctW5j-Vm=VXojfXKZ_CZUo56-QLmA@mail.gmail.com>
To: Nikita Popov <nikita.ppv@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=001a11c21eda7c5ffb04ff01db93
Subject: Re: [PHP-DEV] About PHP NG "document lacking" argument
From: tyra3l@gmail.com (Ferenc Kovacs)

--001a11c21eda7c5ffb04ff01db93
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: quoted-printable

On Fri, Jul 25, 2014 at 12:12 PM, Nikita Popov <nikita.ppv@gmail.com> wrote=
:

> 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 Dmitr=
y
>> > and Ferenc said, much progress has been made there.
>> >
>> > I think we'd all welcome a new edition of the Sara book, but it happen=
s
>> > 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, perhap=
s
>> > 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 w=
e
>> 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 t=
he
> current API, I expect that it may still undergo non-trivial changes befor=
e
> 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!

--=20
Ferenc Kov=C3=A1cs
@Tyr43l - http://tyrael.hu

--001a11c21eda7c5ffb04ff01db93--