DOC: address review comments

Author: bsipocz

astroquery/ipac/irsa/core.py

@@ -15,9 +15,10 @@
 from pyvo.dal import TAPService
 
 try:
-    from pyvo.dal.sia2 import SIA2Service
+    from pyvo.dal.sia2 import SIA2Service, SIA2_PARAMETERS_DESC
 except ImportError:
     # Can be removed once min version of pyvo is 1.5
+    from pyvo.dal.sia2 import SIA_PARAMETERS_DESC as SIA2_PARAMETERS_DESC
     from pyvo.dal.sia2 import SIAService as SIA2Service
 
 from astroquery import log
@@ -118,6 +119,13 @@ def query_sia(self, *, pos=None, band=None, time=None, pol=None,
             maxrec=maxrec,
             **kwargs)
 
+    # SIA2_PARAMETERS_DESC contains links that Sphinx can't resolve.
+    # SIA2_PARAMETERS_DESC contains links that Sphinx can't resolve.
+    for var in ('POLARIZATION_STATES', 'CALIBRATION_LEVELS'):
+        SIA2_PARAMETERS_DESC = SIA2_PARAMETERS_DESC.replace(f'`pyvo.dam.obscore.{var}`',
+                                                            f'pyvo.dam.obscore.{var}')
+    query_sia.__doc__ = query_sia.__doc__.replace('_SIA2_PARAMETERS', SIA2_PARAMETERS_DESC)
+
     @deprecated_renamed_argument(("selcols", "cache", "verbose"), ("columns", None, None), since="0.4.7")
     def query_region(self, coordinates=None, *, catalog=None, spatial='Cone',
                      radius=10 * u.arcsec, width=None, polygon=None,

docs/ipac/irsa/irsa.rst

@@ -238,7 +238,8 @@ Enhanced Imaging products in the centre of the COSMOS field as an `~astropy.tabl
 
 Now open a cutout image for one of the science images. You could either use
 the the IRSA on-premise data or the cloud version of it using the
-``access_url`` or ``cloud_access`` columns:
+``access_url`` or ``cloud_access`` columns. For more info about fits
+cutouts, please visit :ref:`astropy:fits_io_cloud`.
 
 .. doctest-remote-data::