Re: Remove "Hacker's Guide" from the PHP manual?
| From: | Kalle Sommer Nielsen | Date: | Wed, 28 Mar 2018 00:26:26 +0000 |
| Subject: | Re: Remove "Hacker's Guide" from the PHP manual? | ||
| References: | 1 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386905@lists.php.net to get a copy of this message | ||
Hi
2018-03-28 1:11 GMT+02:00 Christoph M. Becker <cmbecker69@gmx.de>:
> Hi everybody!
>
> 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?
We tried to keep this up to date many time in the past, but only a few
of the active documentors are also core developers, and I don't think
it can kept reliably up-to-date unless we write some automatted tools
to generate DocbookXML files, which I doubt anyone will take the time
to invest in. For me, I think it serves us better to delete this
section entirely.
+1 on removal
--
regards,
Kalle Sommer Nielsen
kalle@php.net