Edit report at https://bugs.php.net/bug.php?id=33045&edit=1
ID: 33045
Updated by: krakjoe@php.net
Reported by: cweiske at cweiske dot de
Summary: reflection api is not documented
-Status: Open
+Status: Wont fix
Type: Documentation Problem
Package: Reflection related
Operating System: any
PHP Version: Irrelevant
Block user comment: N
Private report: N
New Comment:
We can wrap this one up ...
It's not just Christoph that thinks internals documentation doesn't belong in the manual,
this is certainly the modern consensus among internals developers.
There is an external attempt to maintain some useful documentation which Christoph mentioned, and
even that is lagging behind and is incomplete.
I'm going to close this as Won't Fix, as it seems outside of the scope of normal
documentation.
Previous Comments:
------------------------------------------------------------------------
[2019-06-28 11:36:05] cmb@php.net
Well, since quite a while I don't think it makes sense to add
internals documentation to the PHP manual, because there is
insufficient man power to maintain what's already there. In my
opinion, out-dated documentation is worse than no documentation.
Unassigning myself, so that perhaps somebody else will take this
to <http://www.phpinternalsbook.com/> or
somewhere else, where it
can be maintained.
Thanks!
------------------------------------------------------------------------
[2016-06-29 19:02:51] cmb@php.net
> Yes, I agree to the license change and copyright transfer.
Thanks. Will include the doc ASAP.
------------------------------------------------------------------------
[2016-06-29 18:41:10] cweiske@php.net
Yes, I agree to the license change and copyright transfer.
------------------------------------------------------------------------
[2016-06-29 18:33:22] cmb@php.net
> I've restored the file.
Thanks. Having had a quick glance at the file, it seems to be a
good addition to "PHP at the Core: A Hacker's Guide"[1]. To do so
would require to transfer the copyright to the "PHP Documentation
Group" and to change the license to CC BY 3.0[2]. Would you agree
to do so?
[1] <http://php.net/manual/en/internals2.php>
[2] <http://php.net/manual/en/copyright.php>
------------------------------------------------------------------------
[2016-06-29 18:15:20] cweiske@php.net
I've restored the file.
------------------------------------------------------------------------
The remainder of the comments for this report are too long. To view
the rest of the comments, please view the bug report online at
https://bugs.php.net/bug.php?id=33045
--
Edit this bug report at https://bugs.php.net/bug.php?id=33045&edit=1