FIX: Opt-in default

Author: larsoner

doc/install.rst

@@ -46,7 +46,7 @@ numpydoc_xref_param_type : bool
   Whether to create cross-references for the parameter types in the
   ``Parameters``, ``Other Parameters``, ``Returns`` and ``Yields``
   sections of the docstring.
-  ``True`` by default.
+  ``False`` by default.
 numpydoc_xref_aliases : dict
   Mappings to fully qualified paths (or correct ReST references) for the
   aliases/shortcuts used when specifying the types of parameters.
@@ -79,7 +79,6 @@ numpydoc_xref_aliases : dict
 
    This option depends on the ``numpydoc_xref_param_type`` option
    being ``True``.
-
 numpydoc_xref_ignore : set
     Words not to cross-reference. Most likely, these are common words
     used in parameter type descriptions that may be confused for
@@ -88,7 +87,6 @@ numpydoc_xref_ignore : set
         numpydoc_xref_ignore = {'type', 'optional', 'default'}
 
     The default is an empty set.
-
 numpydoc_edit_link : bool
   .. deprecated:: edit your HTML template instead
 

numpydoc/numpydoc.py

@@ -197,7 +197,7 @@ def setup(app, get_doc_object_=get_doc_object):
     app.add_config_value('numpydoc_show_inherited_class_members', True, True)
     app.add_config_value('numpydoc_class_members_toctree', True, True)
     app.add_config_value('numpydoc_citation_re', '[a-z0-9_.-]+', True)
-    app.add_config_value('numpydoc_xref_param_type', True, True)
+    app.add_config_value('numpydoc_xref_param_type', False, True)
     app.add_config_value('numpydoc_xref_aliases', dict(), True)
     app.add_config_value('numpydoc_xref_ignore', set(), True)