look for example at
https://github.com/jackalope/jackalope/blob/master/src/Jackalope/Node.php

imo it should be standard to document the type of properties as well. no
long descriptions unless its really needed (not even a short one if its
obvious). but the `@var` should always be there at least.