Re: Remove "Hacker's Guide" from the PHP manual?

From: 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

« previous php.doc (#969386905) next »