updating based on review

Author: ceb8

astroquery/atomic/core.py

@@ -142,7 +142,7 @@ def query_object(self, *, wavelength_range=None, wavelength_type=None, wavelengt
 
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------

astroquery/casda/core.py

@@ -115,7 +115,7 @@ def query_region_async(self, coordinates, *, radius=1*u.arcmin, height=None, wid
             Just return the dict of HTTP request parameters.
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------

astroquery/esa/hsa/core.py

@@ -67,7 +67,7 @@ def download_data(self, *, retrieval_type="OBSERVATION", observation_id=None,
             The directory in which the file will be downloaded
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------

astroquery/esa/xmm_newton/core.py

@@ -106,7 +106,7 @@ def download_data(self, observation_id, *, filename=None, verbose=False,
             values: ASC, ASZ, FTZ, HTM, IND, PDF, PNG
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------

astroquery/eso/core.py

@@ -313,7 +313,7 @@ def list_instruments(self, *, cache=True):
         instrument_list : list of strings
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         """
         if self._instrument_list is None:
@@ -337,7 +337,7 @@ def list_surveys(self, *, cache=True):
         survey_list : list of strings
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
         """
         if self._survey_list is None:
             survey_list_response = self._request(
@@ -375,7 +375,7 @@ def query_surveys(self, *, surveys='', cache=True,
             survey names.
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------
@@ -440,7 +440,7 @@ def query_main(self, *, column_filters={}, columns=[],
             ``instrument``.
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------
@@ -478,7 +478,7 @@ def query_instrument(self, instrument, *, column_filters={}, columns=[],
             ``instrument``.
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------
@@ -556,7 +556,7 @@ def get_headers(self, product_ids, *, cache=True):
             List of data product IDs.
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------

astroquery/heasarc/core.py

@@ -43,7 +43,7 @@ def query_async(self, request_payload, *, cache=True, url=None):
         control of the query to be submitted.
 
         cache (bool) defaults to True. If set overrides global caching behavior.
-        See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+        See :ref:`caching documentation <astroquery_cache>`.
         """
 
         if url is None:
@@ -58,7 +58,7 @@ def query_mission_list(self, *, cache=True, get_query_payload=False):
         Returns a list of all available mission tables with descriptions
 
         cache (bool) defaults to True. If set overrides global caching behavior.
-        See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+        See :ref:`caching documentation <astroquery_cache>`.
         """
         request_payload = self._args_to_payload(
             entry='none',
@@ -99,7 +99,7 @@ def query_mission_cols(self, mission, *, cache=True, get_query_payload=False,
             * <custom>      : User defined csv list of columns to be returned
         cache : bool, optional
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
         All other parameters have no effect
         """
 
@@ -132,7 +132,7 @@ def query_object_async(self, object_name, mission, *,
             Mission table to search from
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
         **kwargs :
             see `~astroquery.heasarc.HeasarcClass._args_to_payload` for list
             of additional parameters that can be used to refine search query
@@ -173,7 +173,7 @@ def query_region_async(self, position: Union[coordinates.SkyCoord, str],
             e.g., '1 degree' or 1*u.degree.
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
         **kwargs :
             see `~astroquery.heasarc.HeasarcClass._args_to_payload` for list
             of additional parameters that can be used to refine search query

astroquery/ipac/irsa/ibe/core.py

@@ -259,7 +259,7 @@ def list_missions(self, *, cache=True):
         ----------
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest
+            See :ref:`caching documentation <astroquery_cache>`.
         """
         if hasattr(self, '_missions') and cache:
             # extra level caching to avoid redoing the BeautifulSoup parsing
@@ -290,7 +290,7 @@ def list_datasets(self, *, mission=None, cache=True):
             configured Mission
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------
@@ -334,7 +334,7 @@ def list_tables(self, *, mission=None, dataset=None, cache=True):
             ``list_datsets(mission)``.  Defaults to the configured Dataset
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------

astroquery/jplhorizons/core.py

@@ -582,7 +582,7 @@ def ephemerides_async(self, *, airmass_lessthan=99,
 
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
 
         Returns
@@ -831,7 +831,7 @@ def elements_async(self, *, get_query_payload=False,
 
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
 
         Returns
@@ -1068,7 +1068,7 @@ def vectors_async(self, *, get_query_payload=False,
 
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
 
         Returns

astroquery/jplsbdb/core.py

@@ -109,7 +109,7 @@ def query_async(self, targetid, *, id_type='search',
             Default: ``False``
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------

astroquery/jplspec/core.py

@@ -66,7 +66,7 @@ def query_lines_async(self, min_frequency, max_frequency, *,
             parameters as a dict. Default value is set to False
         cache : bool
             Defaults to True. If set overrides global caching behavior.
-            See [caching documentation](https://astroquery.readthedocs.io/en/latest/index.html#caching).
+            See :ref:`caching documentation <astroquery_cache>`.
 
         Returns
         -------