On Sat, Apr 30, 2016 at 3:52 PM, Lester Caine <les...@lsces.co.uk> wrote: > 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.
Annotations/Attributes define new behaviors or properties and is used by whatever will process the annotations/attributes. Indeed they provide a bit more information for the user but this is a side-effect, not a goal. Documentations (docblock fe) is used to generate documentation or is used as inlined doc, by human for human. I understand (that) users can see as similar or same but it is critical to keep in mind that they are not, at all. That would help to design and implement what we need for attributes or annotations support. Cheers, -- Pierre @pierrejoye | http://www.libgd.org -- PHP Internals - PHP Runtime Development Mailing List To unsubscribe, visit: http://www.php.net/unsub.php
