Did you generate the sphinx html docs locally and check that everything looks fine?

I think the first line of each comment needs to end with a full-stop `.`, this is the sign for numpydoc that the short description of a function is finished. I might be wrong though and this could also work.