docblocks, polishing