Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:82230
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.192.54 as permitted sender)
MIME-Version: 1.0
Sender: yohgaki@gmail.com
In-Reply-To: <54D83C15.4010104@php.net>
References: <54D3EE95.2080109@lerdorf.com> <sujfdatecf5pep3c5nangetirp0373kha7@4ax.com>
 <54D83C15.4010104@php.net>
Date: Mon, 9 Feb 2015 16:10:29 +0900
Message-ID: <CAGa2bXbf6=jXq12Of4zjucHHtYoHU03TynGVc2Ybm0m4VFB4ng@mail.gmail.com>
To: Maciej Sobaczewski <sobak@php.net>
Cc: "internals@lists.php.net" <internals@lists.php.net>, Jan Ehrhardt <phpdev@ehrhardt.nl>
Content-Type: multipart/alternative; boundary=001a11c130547c500d050ea279ec
Subject: Re: [PHP-DEV] Re: Annotated PHP 5->7 extension diff
From: yohgaki@ohgaki.net (Yasuo Ohgaki)

--001a11c130547c500d050ea279ec
Content-Type: text/plain; charset=UTF-8

Hi Maciej,

On Mon, Feb 9, 2015 at 1:48 PM, Maciej Sobaczewski <sobak@php.net> wrote:

> I'm totally aware that those files are tend to be more up-to-date thanks
> to placing them directly where core developers work. However, we have wiki
> pages for internals stuff, so why not move it to the manual and provide
> better "Zend Hacker's Guide"? There were some complaints about its
> incompleteness and creation of Zend Engine 3 is a great opportunity to fix
> it.


Manual build system is awesome, but writing manual is pain indeed
because it's sgml. For new release, updating the manual to current
state would be difficult. We have missing items even in text files in
source. I agree with you in general, but it's just not feasible it seems.
I also have number of doc bugs that are not fixed yet...

I had to spent few hours to know/get used to ZE3 API. However, thanks
to folks who ported most of modules, I didn't had much problem. ZE3
API is more developer friendly than ZE2 as well.

Basic stuff should be in source. IMO.
Perhaps, we should use only the Wiki for additional internal stuff from now
on.
Keeping in sync wiki and manual seems to hard, but nobody will prevent make
this effort if you would like to. ZE3 manual section is nice to have, but
it may
be better to use only wiki until we release PHP7.

Regards,

--
Yasuo Ohgaki
yohgaki@ohgaki.net

--001a11c130547c500d050ea279ec--