Newsgroups: php.internals
Path: news.php.net
Xref: news.php.net php.internals:99644
Mailing-List: contact internals-help@lists.php.net; run by ezmlm
Received-SPF: pass (pb1.pair.com: domain gmail.com designates 209.85.223.180 as permitted sender)
MIME-Version: 1.0
Sender: kalle.php@gmail.com
In-Reply-To: <CAL=_i_kvGz6K217VUmyk9HU28BHTOXkMXtL7nJ8H7U8BRoHq_Q@mail.gmail.com>
References: <e982c2fa-e08c-0970-53d2-c0d6421c9573@fleshgrinder.com>
 <CAF+90c-9uSA+ykCWg_+pSRdZpJcLoScHawK8MWVGGjCx+dA59g@mail.gmail.com>
 <31e715a7-d129-17f0-b870-52bc1ca1715d@fleshgrinder.com> <af8671d1-9040-39ca-6a8b-fe589d94e2b5@oracle.com>
 <76397c50-1bb6-a777-2f72-25a7ed9981dc@fleshgrinder.com> <HE1PR02MB1052BE9280284A99AA53466BBAD90@HE1PR02MB1052.eurprd02.prod.outlook.com>
 <4f803b88-813d-dacb-db05-248b5e372899@fleshgrinder.com> <HE1PR02MB1052131D94EA1956D5F785A1BAD90@HE1PR02MB1052.eurprd02.prod.outlook.com>
 <CAL=_i_kvGz6K217VUmyk9HU28BHTOXkMXtL7nJ8H7U8BRoHq_Q@mail.gmail.com>
Date: Mon, 26 Jun 2017 14:26:00 +0200
Message-ID: <CAJW__o1LNbu0F80wd5Eo8LWC5U1e4Wz5f=4_WqzRHCryvA4b=Q@mail.gmail.com>
To: Joe Watkins <pthreads@pthreads.org>
Cc: Anatol Belski <weltling@outlook.de>, Fleshgrinder <php@fleshgrinder.com>, 
	php-internals <internals@lists.php.net>
Content-Type: text/plain; charset="UTF-8"
Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen
From: kalle@php.net (Kalle Sommer Nielsen)

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