Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:76115
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.220.175 as permitted sender)
MIME-Version: 1.0
Sender: julienpauli@gmail.com
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 14:08:41 +0200
Message-ID: <CAMUwpuRBz_2FWzziRPyMn8Z6SePHJhgsFf6U1C0ae-OCJoOA=Q@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=089e0117772189a6bf04ff03717d
Subject: Re: [PHP-DEV] About PHP NG "document lacking" argument
From: jpauli@php.net (Julien Pauli)

--089e0117772189a6bf04ff03717d
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).
>

Yuuup it's a hard work often taken from our personnal time about our
personnal experience with the API.

We wouldn't mind at all merging this under php.net and giving it a PHP
licence or something like that.
We wrote this doc for the PHP project somehow to thank it.

It's far from beeing finished, but we should have chapters about the engine
soon (parser - compiler - executor) for example.

For PHP-Next API, whatever it will be , as it is far from beeing stable and
"useful" , this would happen later.

Julien

--089e0117772189a6bf04ff03717d--