audit and update docblocks