On 11/4/14, 3:31 PM, Stas Malyshev wrote:
Hi!
Primarily, I do not see docblocks as the right place to store class'
metadata information. Metadata != Comments.
I personally regard this as a kind of superstition. There's nothing
wrong with extending what can be in comments. In fact, Javascript was
officially "HTML comment" for years, and it didn't prevent anybody from
using Javascript. There are instances of significant comments in various
environments. Outright refusing comments can be significant is just
arbitrarily limiting our options for no reason. I don't say it
necessarily the best option, but we should not reject it because "oh
noes, significant comments!". It has been done, and it's nothing
special, just one of the possibilities
Javascript is a good analogy, actually. It started off as something you
stuck in comments to hide it, just in case. But really, no one does
that anymore and hasn't for years. Once it became obvious that it was
useful, here to say, and any browser anyone cared about supported it
directly it became a first-class citizen, without any comment hacks.
Annotations have been a comment hack in PHP for a long time now. They've
proven their usefulness. Many large projects use them. They've been
proven to work. It's time for them to also become first-class citizens
where we can all benefit from them in more robust ways, including
simplifying the de facto workflow and toolchain.
--Larry Garfield
--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
