MAINT: remove outdated docutils pin

.readthedocs.yml

@@ -13,7 +13,7 @@ sphinx:
 build:
   os: ubuntu-22.04
   tools:
-    python: "3.10"
+    python: "3.12"
   apt_packages:
     - graphviz
   jobs:
@@ -22,7 +22,6 @@ build:
 
 python:
   install:
-    - requirements: docs/requirements.txt
     - method: pip
       path: .
       extra_requirements:

pyvo/io/vosi/endpoint.py

@@ -242,7 +242,7 @@ def version(self, version):
     @xmlelement
     def tableset(self):
         """
-        The tableset. Must be a `TableSet` object.
+        The tableset. Must be a `~pyvo.io.vosi.vodataservice.TableSet` object.
         """
         return self._tableset
 
@@ -259,7 +259,7 @@ def tableset(self, iterator, tag, data, config, pos):
     @xmlelement(cls=vs.VODataServiceTable)
     def table(self):
         """
-        The `VODataServiceTable` root element if present.
+        The `~pyvo.io.vosi.vodataservice.VODataServiceTable` root element if present.
         """
         return self._table
 

pyvo/io/vosi/vodataservice.py

@@ -107,7 +107,7 @@ def version(self, version):
     @xmlelement(name='schema')
     def schemas(self):
         """
-        A list of schemas. Must contain only `Schema` objects.
+        A list of schemas. Must contain only `~pyvo.io.vosi.vodataservice.TableSchema` objects.
 
         A named description of a set of logically related tables.
 
@@ -222,7 +222,8 @@ def utype(self, utype):
     @xmlelement(name='table')
     def tables(self):
         """
-        A list of tables in the schema.  Must contain only `Table` objects.
+        A list of tables in the schema.
+        Must contain only `~pyvo.io.vosi.vodataservice.VODataServiceTable` objects.
 
         A description of one of the tables that makes up the set.
         The table names for the table should be unique.
@@ -429,7 +430,7 @@ def version(self, version):
     def columns(self):
         """
         A list of columns in the table.
-        Must contain only `TableParams` objects.
+        Must contain only `~pyvo.io.vosi.vodataservice.TableParam` objects.
 
         A description of a table column.
         """
@@ -444,7 +445,7 @@ def columns(self, iterator, tag, data, config, pos):
     @xmlelement(name='foreignKey')
     def foreignkeys(self):
         """
-        A list of columns in the table.  Must contain only `ForeignKey` objects
+        A list of columns in the table.  Must contain only `~pyvo.io.vosi.vodataservice.ForeignKey` objects
 
         a description of a foreign keys, one or more columns
         from the current table that can be used to join with
@@ -1004,7 +1005,7 @@ def targettable(self, targettable):
     @xmlelement(name='fkColumn')
     def fkcolumns(self):
         """
-        A list of foreign key columns. Must contain only `FKColumn` objects.
+        A list of foreign key columns. Must contain only `~pyvo.io.vosi.vodataservice.FKColumn` objects.
 
         a pair of column names, one from this table and one
         from the target table that should be used to join the