simplify int type checking again
build a proper docstring for functions