Re: PHP Attributes -> docBloc alternatives ...
| From: | Lester Caine | Date: | Sat, 30 Apr 2016 08:52:54 +0000 |
| Subject: | Re: PHP Attributes -> docBloc alternatives ... | ||
| References: | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 | Groups: | php.internals |
| Request: | Send a blank email to internals+get-92973@lists.php.net to get a copy of this message | ||
On 30/04/16 09:38, Pierre Joye wrote:
>> Sorry if you didn't spend the last 6+ years of your free time
>> > <
>
> https://github.com/phpDocumentor/phpDocumentor2/commit/66dc9069085dcea957508f84e9c79eaf4c234586
>> >
>> > (yes, that is an import) maintaining an open-source project focused on
>> > annotations-based documentation.
> This is not what it does (or I hope it does not). And it makes me sigh to
> read such descriptions. Annotations or attributes are not documentations.
> For the record for this thread :)
It was the use of the 'standard' defined by phpDocumentor2 to 'define'
php-annotations that trigger my current noise, but while I agree with
you, the information contained in what ever method is used to add
'attributes' to the 'annotations' also forms a useful part of any
documentation. In my book the two go hand in hand. Which is why I
changed the title of the thread.
--
Lester Caine - G8HFL
-----------------------------
Contact - http://lsces.co.uk/wiki/?page=contact
L.S.Caine Electronic Services - http://lsces.co.uk
EnquirySolve - http://enquirysolve.com/
Model Engineers Digital Workshop - http://medw.co.uk
Rainbow Digital Media - http://rainbowdigitalmedia.co.uk