Addressing some unresolved doc references

Author: mwatts15

docs/conf.py

@@ -31,7 +31,9 @@
 extensions = ['sphinx.ext.autodoc', 'sphinx.ext.todo', 'sphinx.ext.viewcode',
               'sphinx.ext.intersphinx', 'sphinx.ext.napoleon']
 intersphinx_mapping = {'python': ('https://docs.python.org/3', None),
-                       'rdflib': ('https://rdflib.readthedocs.io/en/stable/', None)}
+                       'rdflib': ('https://rdflib.readthedocs.io/en/stable/', None),
+                       'sqlalchemy': ('https://docs.sqlalchemy.org/en/14/', None),
+                       }
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']
 

rdflib_sqlalchemy/sql.py

@@ -47,8 +47,8 @@ def union_select(select_components, distinct=False, select_type=TRIPLE_SELECT):
         select_components (iterable of tuples): Indicates the table and table type
             (table_name, where_clause_string, table_type)
         distinct (bool): Whether to eliminate duplicate results
-        select_type (int): From `rdflib_sqlalchemy.constants`. Either `COUNT_SELECT`,
-            `CONTEXT_SELECT`, `TRIPLE_SELECT`
+        select_type (int): From `rdflib_sqlalchemy.constants`. Either `.COUNT_SELECT`,
+            `.CONTEXT_SELECT`, `.TRIPLE_SELECT`
 
     """
     selects = []

rdflib_sqlalchemy/statistics.py

@@ -7,10 +7,12 @@ def get_group_by_count(session, group_by_column):
     """
     Construct SQL query to get counts for distinct values using GROUP BY.
 
-    :param session - sqlalchemy `Session` instance
-    :param group_by_column sqlalchemy `Column` instance
-    :returns {dict} dictionary mapping from value to count
+    Args:
+        session (~sqlalchemy.orm.session.Session): session to query in
+        group_by_column (~sqlalchemy.schema.Column): column to group by
 
+    Returns:
+        dict: dictionary mapping from value to count
     """
     return dict(
         session.query(

rdflib_sqlalchemy/store.py

@@ -244,9 +244,9 @@ def open(self, configuration, create=True):
 
         Args:
             configuration: if a string, use as the DBAPI URL. If a dictionary, will use as the
-                `**kwargs` for the sqlalchemy.create_engine() call, and will attempt to
-                extract the connection URL from a 'url' key in that dictionary.
-                A valid connection string will be of the format:
+                ``**kwargs`` for the sqlalchemy.create_engine() call, and will attempt to
+                extract the connection URL from a 'url' key in that dictionary.  A valid
+                connection string will be of the format:
 
                     dialect[+driver]://user:password@host/dbname[?key=value..]