17 at 10:59 PM, Anatol Belski wrote:
-Original Message-
From: Fleshgrinder [mailto:p...@fleshgrinder.com]
Sent: Saturday, June 24, 2017 11:34 PM
To: php-internals ; Anatol Belski
Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen
On 6/24/2017 11:28 PM, Anatol Belski wrote:
I voted no, becau
No from me as well. This is wagging the dog by the tail. Picking a
documentation format is the very least of the concerns here. It would be
wonderful to have better internal API documentation, but putting up any
sort of structural restriction like limiting it to a specific header-based
format, isn'
HI Joe,
2017-06-26 8:43 GMT+02:00 Joe Watkins :
> 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 addit
elski wrote:
>
>
> > -Original Message-
> > From: Fleshgrinder [mailto:p...@fleshgrinder.com]
> > Sent: Saturday, June 24, 2017 11:34 PM
> > To: php-internals ; Anatol Belski
> >
> > Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen
> >
> > O
> -Original Message-
> From: Fleshgrinder [mailto:p...@fleshgrinder.com]
> Sent: Saturday, June 24, 2017 11:34 PM
> To: php-internals ; Anatol Belski
>
> Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen
>
> On 6/24/2017 11:28 PM, Anatol Belski wrote:
> > I vot
On 6/24/2017 11:28 PM, Anatol Belski wrote:
> I voted no, because it is too short term and I'd see a productivity
> drop having such an obligation suddenly right in place for 7.2. To
> implement the change, there's more than just to put the doc into the
> source. Every piece of code needs to be rev
Hi,
> -Original Message-
> From: Fleshgrinder [mailto:p...@fleshgrinder.com]
> Sent: Friday, June 23, 2017 9:20 PM
> To: php-internals ; christopher.jo...@oracle.com
> Subject: Re: [PHP-DEV] [RFC] [Vote] Doxygen
>
> On 6/23/2017 5:12 AM, Christopher Jones wrote:
&g
On 6/23/2017 5:12 AM, Christopher Jones wrote:
> That kind of detail belongs in the RFC.
>
> A link to existing 'prior art' would have rounded the picture out and let
> people decide between alternatives of internal vs external doc.
> E.g. link to https://wiki.php.net/internals/references
>
> Als
On 22/6/17 1:43 am, Fleshgrinder wrote:
On 6/21/2017 5:38 PM, Nikita Popov wrote:
Can you please clarify where functions that are declared in a header and
defined in a source file should be documented? I believe the usual
recommendation is to document in the source file, because it's closer to
On 6/21/2017 5:38 PM, Nikita Popov wrote:
> Can you please clarify where functions that are declared in a header and
> defined in a source file should be documented? I believe the usual
> recommendation is to document in the source file, because it's closer to
> the implementation and thus more lik
On Sat, Jun 17, 2017 at 9:53 AM, Fleshgrinder wrote:
> Hi!
>
> I started voting on the Doxygen RFC:
>
> https://wiki.php.net/rfc/doxygen
>
> --
> Richard "Fleshgrinder" Fussenegge
>
Can you please clarify where functions that are declared in a header and
defined in a source file should be docume
On 6/21/2017 4:13 AM, Christopher Jones wrote:
>
> On 17/6/17 5:53 pm, Fleshgrinder wrote:
>> Hi!
>>
>> I started voting on the Doxygen RFC:
>>
>> https://wiki.php.net/rfc/doxygen
>>
> Did I miss seeing when the vote ends?
>
> Chris
>
You did not, I forgot to mention it. The vote will close on
On 6/19/2017 2:31 PM, Jakub Zelenka wrote:
> On Sat, Jun 17, 2017 at 8:53 AM, Fleshgrinder wrote:
>
>> Hi!
>>
>> I started voting on the Doxygen RFC:
>>
>> https://wiki.php.net/rfc/doxygen
>>
>>
> I just wanted to send my feedback and the reason why I voted "yes". First
> of all I don't really li
On 17/6/17 5:53 pm, Fleshgrinder wrote:
Hi!
I started voting on the Doxygen RFC:
https://wiki.php.net/rfc/doxygen
Did I miss seeing when the vote ends?
Chris
--
http://twitter.com/ghrd
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub
On Sat, Jun 17, 2017 at 8:53 AM, Fleshgrinder wrote:
> Hi!
>
> I started voting on the Doxygen RFC:
>
> https://wiki.php.net/rfc/doxygen
>
>
I just wanted to send my feedback and the reason why I voted "yes". First
of all I don't really like adding too much documentation to the code (I'm
actually
15 matches
Mail list logo