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 will 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 adielcri...@gmail.com LinkedIn <http://br.linkedin.com/in/adielcristo> On Fri, Jan 24, 2020 at 5:49 AM Christoph M. Becker <cmbecke...@gmx.de> wrote: > On 23.01.2020 at 13:07, Daniel Martín 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 NumPy > > 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 > >
