improved docstring checking + first round of fixes