I'm all for using docblocks but we should try to standardize our use across the source. You can commit whatever you have here and I'm going to create a new issue to retrofit the rest of the codebase. Lets discuss docblocks on that task!