correct return types in doc blocks