Hi
My name is Carlos Granados and I have been a PHP developer for a long time,
more than 15 years and I am quite interested in the PHP internals and
trying to learn as much as I can about them
This page in the Wiki https://wiki.php.net/internals/references has a lot
of links which are outdated and should be removed or changed. If you can
provide wiki edit access for me I can work on updating them and also try to
find more recent links to add to that reference page (suggestions welcome!!)
My username for the wiki site is "barelon" in case this is needed
Cheers
Carlos
Hi Carlos!
This page in the Wiki https://wiki.php.net/internals/references has a lot
of links which are outdated and should be removed or changed. If you can
provide wiki edit access for me I can work on updating them and also try to
find more recent links to add to that reference page (suggestions welcome!!)My username for the wiki site is "barelon" in case this is needed
I can absolutely give you write access to these pages. Updating this
list to reflect more up-to-date resources certainly makes sense.
As you probably know, there are a number of different places where php
internals are documented, and I think that, long-term, it makes sense
to try to consolidate these efforts. We briefly spoke about this in
the last foundation meeting.
We have some documentation in the php-src repository itself, a
significant amount in the php internals book
(https://www.phpinternalsbook.com/), some in the wiki, some on blogs
of current or previous contributors, etc. There are a number of things
that are important when it comes to documentation, like convenience,
access, history, discoverability, etc.
While not the worst, I don't think the wiki is the best place for this
work. Handling documentation directly through Git in PHPs main
repository (or at least a repository in the PHP organization) would
likely tick the most boxes. Providing documentation with PRs might
also improve the understanding of intention of the changes for
reviewers.
As for links to other references, I believe the CONTRIBUTING.md file
is currently the most up-to-date.
https://github.com/php/php-src/blob/master/CONTRIBUTING.md#technical-resources
Rather than duplicating this list on the wiki, it might make sense to
reference the CONTRIBUTING.md file, and extend it as necessary.
Ilija