docs: set up Sphinx with working ReadTheDocs config

- Add docs optional-dependencies group (sphinx, tomli) to pyproject.toml
- Wire up .readthedocs.yaml to install .[docs] extra
- Fix conf.py: correct pyproject.toml path, use importlib.metadata for
  version, switch to alabaster theme, use tomllib/tomli compat import
- Add minimal docs/index.rst
- Fix RST docstring errors in connection_item, site_item, job_item,
  task_item that caused Sphinx build warnings/errors

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: jacalata

.readthedocs.yaml

@@ -17,7 +17,9 @@ sphinx:
 # Optionally, but recommended,
 # declare the Python requirements required to build your documentation
 # See https://docs.readthedocs.io/en/stable/guides/reproducible-builds.html
-# python:
-#    install:
-#    - requirements: docs/requirements.txt
-        
+python:
+   install:
+   - method: pip
+     path: .
+     extra_requirements:
+     - docs

docs/conf.py

@@ -12,17 +12,22 @@
 
 # conf.py
 
-import tomli
-with open("../../pyproject.toml", "rb") as f:
-    toml = tomli.load(f)
+try:
+    import tomllib
+except ImportError:
+    import tomli as tomllib
 
-# -- Project information -----------------------------------------------------
+from pathlib import Path
+import importlib.metadata
+
+with open(Path(__file__).parent.parent / "pyproject.toml", "rb") as f:
+    toml = tomllib.load(f)
 
-pyproject = toml["tool"]["setuptools"]
+# -- Project information -----------------------------------------------------
 
-project = pyproject["name"]
-version = pyproject["version"]
-release = pyproject["version"]
+project = toml["project"]["name"]
+release = importlib.metadata.version(project)
+version = ".".join(release.split(".")[:2])
 
 # -- General configuration ---------------------------------------------------
 # -- General configuration
@@ -54,9 +59,9 @@
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
 #
-html_theme = "sphinx_rtd_theme"
+html_theme = "alabaster"
 
 # Add any paths that contain custom static files (such as style sheets) here,
 # relative to this directory. They are copied after the builtin static files,
 # so a file named "default.css" will overwrite the builtin "default.css".
-html_static_path = ["_static"]
+html_static_path = []

docs/index.rst

@@ -0,0 +1,9 @@
+tableauserverclient
+===================
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Contents:
+
+.. automodule:: tableauserverclient
+   :members:

pyproject.toml

@@ -35,6 +35,7 @@ repository = "https://github.com/tableau/server-client-python"
 [project.optional-dependencies]
 test = ["black==26.5.1", "build", "mypy==2.3.0", "pytest>=7.0", "pytest-cov", "pytest-subtests",
     "pytest-xdist", "requests-mock>=1.0,<2.0", "types-requests>=2.32.4.20250913"]
+docs = ["sphinx", "tomli"]
 
 [tool.setuptools.package-data]
 # Only include data for tableauserverclient, not for samples, test, docs

tableauserverclient/models/connection_item.py

@@ -150,16 +150,7 @@ def from_response(cls, resp, ns) -> list["ConnectionItem"]:
 
     @classmethod
     def from_xml_element(cls, parsed_response, ns) -> list["ConnectionItem"]:
-        """
-        <connections>
-            <connection serverAddress="mysql.test.com">
-                <connectionCredentials embed="true" name="test" password="secret" />
-            </connection>
-            <connection serverAddress="pgsql.test.com">
-                <connectionCredentials embed="true" name="test" password="secret" />
-                </connection>
-        </connections>
-        """
+        """Parse connection items from an XML ``<connections>`` element."""
         all_connection_items: list["ConnectionItem"] = list()
         all_connection_xml = parsed_response.findall(".//t:connection", namespaces=ns)
 

tableauserverclient/models/job_item.py

@@ -27,7 +27,7 @@ class JobItem:
 
     Parameters
     ----------
-    id_ : str
+    id : str
         The identifier of the job.
 
     job_type : str

tableauserverclient/models/site_item.py

@@ -52,10 +52,13 @@ class SiteItem:
         cause an error.
 
     tier_explorer_capacity: int
+        (Optional) The maximum number of licenses for users with the Explorer role allowed on a site.
+
     tier_creator_capacity: int
+        (Optional) The maximum number of licenses for users with the Creator role allowed on a site.
+
     tier_viewer_capacity: int
-        (Optional) The maximum number of licenses for users with the Creator,
-        Explorer, or Viewer role, respectively, allowed on a site.
+        (Optional) The maximum number of licenses for users with the Viewer role allowed on a site.
 
     storage_quota: int
         (Optional) Specifies the maximum amount of space for the new site, in

tableauserverclient/models/task_item.py

@@ -13,7 +13,7 @@ class TaskItem:
 
     Parameters
     ----------
-    id_ : str
+    id : str
         The ID of the task.
 
     task_type : str