fix some docblocks and typehints