Personally, I think that if a class is an implementation of an
interface, their methods' docblocks should stick to the interface
methods' docblocks as they are, because that fits better with the
purpose behind using interfaces in 1st place, and that's what I always
do in my code...
That being said, I'm not sure how you'd implement "eliminating @todo
entries which aren't applicable to the implementation", because note
that you can have multiple @todo entries in the interface! how do you
identify which one is the one you want to eliminate?
For something like @throws, it's the same thing, although at least you
can identify each tag by the exception they throw - anyway, you'd need
something like a new "negation tag" like @not-throws (?), so you can
override each specific exception that might be defined in the
implementation... or am I missing something?
As I said, *personally* I don't consider this an important feature to
focus on...
Daniel Hunsaker wrote on 28/11/2018 17:04:
Personally, I think that if a class is an implementation of an
interface, their methods' docblocks should stick to the interface
methods' docblocks as they are, because that fits better with the
purpose behind using interfaces in 1st place, and that's what I always
do in my code...
That being said, I'm not sure how you'd implement "eliminating @todo
entries which aren't applicable to the implementation", because note
that you can have multiple @todo entries in the interface! how do you
identify which one is the one you want to eliminate?
For something like @throws, it's the same thing, although at least you
can identify each tag by the exception they throw - anyway, you'd need
something like a new "negation tag" like @not-throws (?), so you can
override each specific exception that might be defined in the
implementation... or am I missing something?
As I said, *personally* I don't consider this an important feature to
focus on...
--
You received this message because you are subscribed to the Google Groups "PHP
Framework Interoperability Group" group.
To unsubscribe from this group and stop receiving emails from it, send an email
to php-fig+unsubscr...@googlegroups.com.
To post to this group, send email to php-fig@googlegroups.com.
To view this discussion on the web visit
https://groups.google.com/d/msgid/php-fig/e683b5f9-e23b-b371-a407-2fd4c036852a%40gmail.com.
For more options, visit https://groups.google.com/d/optout.
