I don't necessarily have a problem with encouraging people towards PhpStorm / Magicento if they're concerned about docblock / autocompletion as you seemed to be.

I don't want to get too hung up on code style issues, but unless you feel strongly about it, I'd rather pull these extraneous docblock comments out.