Re: Remove "Hacker's Guide" from the PHP manual?
| From: | Christoph M. Becker | Date: | Thu, 05 Apr 2018 11:43:49 +0000 |
| Subject: | Re: Remove "Hacker's Guide" from the PHP manual? | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386913@lists.php.net to get a copy of this message | ||
On 28.03.2018 at 01:11, Christoph M. Becker wrote:
> In my opinion, we should remove the internals2 book[1] (“PHP at the
> Core: A Hacker's Guide”) from the PHP manual, since it is still not
> basically up-to-date with PHP 7 (and nobody seems to be working on
> that). Actually, it even states[2]:
>
> | The documentation in this section is current as of PHP 5.3.3, […]
>
> And there is at least one bug report[3] about this.
>
> Instead of investing a lot of time to update the book, I think it is
> more sensible to replace it with a single page which links to external
> documentation, such as
> <http://www.phpinternalsbook.com/>, and to help
> improving and keeping the external docs up to date, if appropriate.
>
> Thoughts?
>
> [1] <http://www.php.net/manual/en/internals2.php>
> [2] <http://www.php.net/manual/en/internals2.preface.php>
> [3] <https://bugs.php.net/bug.php?id=73014>
Thanks for the positive feedback so far!
Christopher Jones mentioned <https://wiki.php.net/internals/references>
in a private communication, which might be the better place to refer to
external documantion.
Anyhow, I wouldn't remove the "Hacker's Guide" without the blessing of
the manual's editor. Peter, what do you think?
--
Christoph M. Becker