Merge pull request astropy#3628 from bsipocz/docs_cleanup_regions

DOC: cleanup regions links

Author: bsipocz

astroquery/alma/core.py

@@ -217,7 +217,7 @@ def get_enhanced_table(result):
     except ImportError:
         print(
             "Could not import astropy-regions, which is a requirement for get_enhanced_table function in alma."
-            "Please refer to https://astropy-regions.readthedocs.io/en/latest/installation.html for how to install it.")
+            "Please refer to the ``regions`` documentation for installation instructions.")
         raise
 
     def _parse_stcs_string(input):
@@ -494,7 +494,7 @@ def query_object_async(self, object_name, *, public=True,
             calibration, None to return both
         enhanced_results : bool
             True to return a table with quantities instead of just values. It
-            also returns the footprint as `regions` objects.
+            also returns the footprint as ``regions`` objects.
         payload : dict
             Dictionary of additional keywords.  See `help`.
         """
@@ -528,7 +528,7 @@ def query_region_async(self, coordinate, radius, *, public=True,
             Dictionary of additional keywords.  See `help`.
         enhanced_results : bool
             True to return a table with quantities instead of just values. It
-            also returns the footprints as `regions` objects.
+            also returns the footprints as ``regions`` objects.
         """
         rad = radius
         if not isinstance(radius, u.Quantity):
@@ -571,7 +571,7 @@ def query_async(self, payload, *, public=True, science=True,
             Cap on the amount of records returned.  Default is no limit.
         enhanced_results : bool
             True to return a table with quantities instead of just values. It
-            also returns the footprints as `regions` objects.
+            also returns the footprints as ``regions`` objects.
 
         Returns
         -------

docs/alma/alma.rst

@@ -350,7 +350,7 @@ Query Results
 Results of queries are returned in tabular format. For convenience,
 the `~astroquery.alma.get_enhanced_table` function can be used to have the initial result
 in a more useful format, i.e., turn values into quantities, footprint into
-shape, etc. (Note: this require the `regions` Python package to be installed.
+shape, etc. (Note: this require the `regions`_ Python package to be installed.)
 
 
 .. doctest-remote-data::
@@ -400,7 +400,7 @@ To further draw the footprint:
 
 The above footprint could be transformed into a pixel region and have the mask
 extracted or combined with other regions. Refer to the Astropy affiliated
-''regions'' package for more details.
+`regions`_ package for more details.
 
 
 Downloading Data
@@ -521,3 +521,6 @@ Reference/API
 
 .. automodapi:: astroquery.alma.utils
     :no-inheritance-diagram:
+
+
+.. _regions: https://astropy-regions.readthedocs.io

docs/conf.py

@@ -12,7 +12,6 @@
 # See astropy.sphinx.conf for which values are set there.
 
 import datetime
-import os
 import sys
 import tomllib
 from pathlib import Path