Newsgroups: php.doc,php.internals
Path: news.php.net
Xref: news.php.net php.doc:969387452 php.internals:108239
MIME-Version: 1.0
References: <CAOHbTA5O2ZPxmBJ=jm2kkf2y+tJ_EHhtJCyP+2v7bE=7v2KYzw@mail.gmail.com>
 <dba72e85-e85c-86c6-47a8-acf9cb80c87d@gmx.de>
In-Reply-To: <dba72e85-e85c-86c6-47a8-acf9cb80c87d@gmx.de>
Date: Sat, 25 Jan 2020 10:23:43 -0300
Message-ID: <CAHiLRo5Zj+7gk1UfSbiBQLPNCR=oYoDSeXsex36=_3JNStc6Dg@mail.gmail.com>
To: "Christoph M. Becker" <cmbecker69@gmx.de>
Cc: =?UTF-8?Q?Daniel_Mart=C3=ADn_Spiridione?= <daniel.spiridione@gmail.com>, 
	PHP internals <internals@lists.php.net>, PHP Doc Mailing List <phpdoc@lists.php.net>
Content-Type: multipart/alternative; boundary="00000000000037c69a059cf6c924"
Subject: Re: [PHP-DEV] Re: A Hacker's Guide - Obsolete
From: adielcristo@gmail.com (Adiel Cristo)

--00000000000037c69a059cf6c924
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

Yep!

I still believe that having only external references about the internals of
PHP
works against us, in the sense that as we develop the language, we should
be the first ones to provide the documentation about how to do it.

We have a great user documentation, thank you guys for that, and I'm proud
of
having contributed with a few translations until now.

I don't know exactly what kind of differences of opinion resulted in a
separate
internals documentation (and with a different license), and I know that wil=
l
demand a monumental effort to start to update ours.

I'm committed with learning the minimum necessary to having at least a
simple
documentation, and I already started that, although with a long delay from
what
I planned due to other projects, but I'm working on it.

Considering that the decision isn't taken yet, if you need a deadline to
delete
the outdated internals section or to maintain only the external references
I propose the release date of PHP 8. Any objections?

Kind regards,
*Adiel Cristo*
Senior PHP Developer
adielcristo@gmail.com
LinkedIn <http://br.linkedin.com/in/adielcristo>


On Fri, Jan 24, 2020 at 5:49 AM Christoph M. Becker <cmbecker69@gmx.de>
wrote:

> On 23.01.2020 at 13:07, Daniel Mart=C3=ADn Spiridione wrote:
>
> > Hi interns. The official PHP.net documentation of the "PHP at the Core:=
 A
> > Hacker's Guide" section (https://www.php.net/manual/en/internals2.php)
> is
> > obsolete.
> >
> > In that sense Python has good documentation to be extended in C / C ++.=
 I
> > think this is also one of the reasons why there are libraries like NumP=
y
> > and others that have popularized Python for data science.
> >
> > I personally know that the project http://www.phpinternalsbook.com
> exists.
> > While this book is not yet fully updated to PHP 7, the information it
> > provides is wonderful!
> >
> > I think the "A Hacker's Guide" documentation should clarify that it is
> > outdated and incomplete and at least reference the project
> > http://www.phpinternalsbook.com
> >
> > What do you think?
>
> I have suggested to remove this section from the manual and to replace
> it with a page linking to external documentation long ago, but see
> <https://news-web.php.net/php.doc/969386915>.
>
> Thanks,
> Christoph
>
> --
> PHP Internals - PHP Runtime Development Mailing List
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>

--00000000000037c69a059cf6c924--