Re: [RFC] [Vote] Doxygen
| From: | Kalle Sommer Nielsen | Date: | Mon, 26 Jun 2017 12:26:00 +0000 |
| Subject: | Re: [RFC] [Vote] Doxygen | ||
| References: | 1 2 3 4 5 6 7 8 9 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-99644@lists.php.net to get a copy of this message | ||
HI Joe,
2017-06-26 8:43 GMT+02:00 Joe Watkins <pthreads@pthreads.org>:
> Morning,
>
> I also voted no for similar reasons to Anatol.
>
> This is not really a thing that needs a vote, this is a thing that requires
> the handful of people who are actually able to document ZE to spend
> considerable time doing so. In addition it requires a commitment from the
> community of developers to continue to maintain, and introduce inline
> documentation with new code.
>
> Additionally, I'm a little concerned that an RFC that has the potential to
> touch every single source file has gone to vote with a simple majority. It
> would seem that we are deciding that new code must be documented in this
> specific way, to say nothing of the massive task of documenting existing
> code. That would seem to be a decision that could effect everybody that
> works on PHP in perpetuity and a simple majority is nothing like a strong
> enough consensus.
I'm in the same boat as you and Anatol here.
I think it is important to note that all who actively work on the
Core/Engine have no except for Stas, which also should be a good
indicator that we should be concerned.
--
regards,
Kalle Sommer Nielsen
kalle@php.net