global code style: In doc comment, if the parameter type is one word, put it in the param directive, not a separate type directive.
global code style: In doc comment, put the exception type inside the raises directive.