The only thing we are using the shorthand version like that for are objects. Anything else should be given a full docblock comment.