WIP: Add xref to params in doc

Author: larsoner

build_tools/circle/build_doc.sh

@@ -125,7 +125,7 @@ conda create -n $CONDA_ENV_NAME --yes --quiet python="${PYTHON_VERSION:-*}" \
 
 source activate testenv
 pip install "sphinx-gallery>=0.2,<0.3"
-pip install numpydoc==0.8
+pip install https://api.github.com/repos/larsoner/numpydoc/zipball/xref-param-type
 
 # Build and install scikit-learn in dev mode
 python setup.py develop

doc/conf.py

@@ -43,7 +43,13 @@
 # this is needed for some reason...
 # see https://github.com/numpy/numpydoc/issues/69
 numpydoc_class_members_toctree = False
-
+numpydoc_xref_param_type = True
+numpydoc_xref_aliases = {
+    'integer': ':class:`python:int`',
+}
+numpydoc_xref_ignore = {
+    'shape', 'n_features', 'or', 'optional', 'default',
+}
 
 # For maths, use mathjax by default and svg if NO_MATHJAX env variable is set
 # (useful for viewing the doc offline)