fix docblocks and typos