docs: fixes for api docs

README.md

@@ -1,10 +1,10 @@
 # Zixy
 
-[![CI](https://github.com/quantinuum/zixy/workflows/Unit%20tests/badge.svg)](https://github.com/quantinuum/zixy/actions?query=workflow%3A%22Unit+tests%22+branch%3Amain)
+[![CI](https://github.com/quantinuum/zixy/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/quantinuum/zixy/actions?query=workflow%3A%22Unit+tests%22+branch%3Amain)
 [![PyPI version](https://badge.fury.io/py/zixy.svg)](https://badge.fury.io/py/zixy)
 [![License: Apache-2.0](https://img.shields.io/badge/license-Apache%20License%202.0-blue)](https://opensource.org/license/apache-2.0)
 
-Zixy is a high performance library for the manipulation of Pauli strings and other quantum algebraic objects.
+Zixy™ is a high performance library for the manipulation of Pauli strings and other quantum algebraic objects.
 
 ## Installation
 

zixy-py/README.md

@@ -1,6 +1,6 @@
 # Zixy
 
-[![CI](https://github.com/quantinuum/zixy/workflows/Unit%20tests/badge.svg)](https://github.com/quantinuum/zixy/actions?query=workflow%3A%22Unit+tests%22+branch%3Amain)
+[![CI](https://github.com/quantinuum/zixy/actions/workflows/tests.yml/badge.svg?branch=main)](https://github.com/quantinuum/zixy/actions?query=workflow%3A%22Unit+tests%22+branch%3Amain)
 [![PyPI version](https://badge.fury.io/py/zixy.svg)](https://badge.fury.io/py/zixy)
 [![License: Apache-2.0](https://img.shields.io/badge/license-Apache%20License%202.0-blue)](https://opensource.org/license/apache-2.0)
 

zixy-py/docs/_templates/autosummary/class.rst

@@ -8,12 +8,12 @@
 .. autoclass:: {{ objname }}
    :members:
    :undoc-members:
-   :exclude-members: __module__, __weakref__, __dict__, __annotations__, __dataclass_params__, __dataclass_fields__, __match_args__, __orig_bases__, __parameters__, __firstlineno__, __abstractmethods__, __annotate_func__, __annotations_cache__, __static_attributes__, __protocol_attrs__, __subclasshook__    
-   :special-members:
+   :exclude-members: __module__, __weakref__, __dict__, __annotations__, __dataclass_params__, __dataclass_fields__, __match_args__, __orig_bases__, __parameters__, __firstlineno__, __abstractmethods__, __annotate_func__, __annotations_cache__, __static_attributes__, __protocol_attrs__, __subclasshook__, __class_getitem__, __init_subclass__, __slots__, index, slice, raise_spec_type_error
+   :special-members: __init__, __repr__, __eq__, __len__, __iter__, __getitem__, __setitem__, __add__, __sub__, __mul__, __rmul__, __iadd__, __isub__, __imul__, __itruediv__, __truediv__, __rtruediv__, __pos__, __neg__, __abs__, __int__, __float__, __complex__
    :inherited-members:
    :show-inheritance:
 
    {% block methods %}
    {% if methods %}
    {% endif %}
-   {% endblock %}
+   {% endblock %}

zixy-py/docs/conf.py

@@ -4,7 +4,9 @@
 # For the full list of built-in configuration values, see the documentation:
 # https://www.sphinx-doc.org/en/master/usage/configuration.html
 
+import builtins
 from datetime import datetime
+from typing import Any
 
 # Alias needed here to prevent naming clash with something else sphinx is doing.
 from importlib.metadata import version as check_version
@@ -27,12 +29,18 @@
     "sphinx_copybutton",
     "sphinx.ext.intersphinx",
     "sphinx.ext.autodoc",
+    "sphinx.ext.napoleon",
     "sphinx_autodoc_typehints",
 ]
 
+napoleon_google_docstring = True
+napoleon_use_param = False  # don't show parameter types in description (they're in the signature)
+napoleon_use_rtype = False  # don't show return types in description (they're in the signature)
+
 typehints_use_signature = True  # show parameter types in signature
 typehints_use_signature_return = True  # show return type in signature
 typehints_document_rtype = False
+typehints_fully_qualified = False
 
 templates_path = ["_templates"]
 
@@ -69,3 +77,7 @@
     "scipy": ("https://docs.scipy.org/doc/scipy/", None),
     "sympy": ("https://docs.sympy.org/latest/", None),
 }
+
+
+def setup(app: Any) -> dict[str, bool]:
+    return {"parallel_read_safe": True, "parallel_write_safe": True}

zixy-py/docs/pyproject.toml

@@ -10,8 +10,11 @@ dependencies = [
     "sphinx-copybutton",
     "pandas>=2.3.3",
     "scipy",
-    "zixy==0.2.2",
+    "zixy",
     "sphinx-autodoc-typehints>=3.6.3",
     "jupyterlab",
     "ipykernel>=7.2.0",
 ]
+
+[tool.uv.sources]
+zixy = { path = ".." }