add or fix docblocks