Writing things out is verbose and in my mind makes things harder to read.  However, some comment/doxy is in order.