@cdeil is right - of course, one could try in future and make it so that numpydoc can try and resolve parameter names and link them to the parameter in the docstring, but for now it does not, and parameter names are not valid references.