update docs

Author: matthiasdiener

README.rst

@@ -16,6 +16,7 @@ code to work with all of them? No problem! Comes with pre-made array context
 implementations for:
 
 - numpy
+- cupy
 - `PyOpenCL <https://documen.tician.de/pyopencl/array.html>`__
 - `JAX <https://jax.readthedocs.io/en/latest/>`__
 - `Pytato <https://documen.tician.de/pytato>`__ (for lazy/deferred evaluation)

arraycontext/impl/cupy/__init__.py

@@ -1,14 +1,14 @@
-from __future__ import annotations
-
-
 """
 .. currentmodule:: arraycontext
 
-A mod :`cupy`-based array context.
+A :mod:`cupy`-based array context.
 
 .. autoclass:: CupyArrayContext
 """
 
+from __future__ import annotations
+
+
 __copyright__ = """
 Copyright (C) 2024 University of Illinois Board of Trustees
 """
@@ -64,7 +64,7 @@ class CupyNonObjectArray(metaclass=CupyNonObjectArrayMetaclass):
 
 class CupyArrayContext(ArrayContext):
     """
-    A :class:`ArrayContext` that uses :class:`cupy.ndarray` to represent arrays.
+    An :class:`ArrayContext` that uses :class:`cupy.ndarray` to represent arrays.
 
     .. automethod:: __init__
     """

arraycontext/impl/numpy/__init__.py

@@ -63,7 +63,7 @@ class NumpyNonObjectArray(metaclass=NumpyNonObjectArrayMetaclass):
 
 class NumpyArrayContext(ArrayContext):
     """
-    A :class:`ArrayContext` that uses :class:`numpy.ndarray` to represent arrays.
+    An :class:`ArrayContext` that uses :class:`numpy.ndarray` to represent arrays.
 
     .. automethod:: __init__
     """

arraycontext/impl/pyopencl/__init__.py

@@ -58,7 +58,7 @@
 
 class PyOpenCLArrayContext(ArrayContext):
     """
-    A :class:`ArrayContext` that uses :class:`pyopencl.array.Array` instances
+    An :class:`ArrayContext` that uses :class:`pyopencl.array.Array` instances
     for its base array class.
 
     .. attribute:: context

doc/Makefile

@@ -3,7 +3,7 @@
 
 # You can set these variables from the command line, and also
 # from the environment for the first two.
-SPHINXOPTS    ?=
+SPHINXOPTS    ?= -W -n
 SPHINXBUILD   ?= python $(shell which sphinx-build)
 SOURCEDIR     = .
 BUILDDIR      = _build

doc/conf.py

@@ -23,6 +23,7 @@
     "pytest": ("https://docs.pytest.org/en/latest/", None),
     "python": ("https://docs.python.org/3/", None),
     "pytools": ("https://documen.tician.de/pytools", None),
+    "cupy": ("https://docs.cupy.dev/en/stable/", None),
 }
 
 # Some modules need to import things just so that sphinx can resolve symbols in

doc/implementations.rst

@@ -13,6 +13,12 @@ Array context based on :mod:`numpy`
 
 .. automodule:: arraycontext.impl.numpy
 
+
+Array context based on :mod:`cupy`
+--------------------------------------------
+
+.. automodule:: arraycontext.impl.cupy
+
 Array context based on :mod:`pyopencl.array`
 --------------------------------------------
 

doc/index.rst

@@ -6,14 +6,15 @@ code to work with all of them? No problem! Comes with pre-made array context
 implementations for:
 
 - :mod:`numpy`
+- :mod:`cupy`
 - :mod:`pyopencl`
 - :mod:`jax.numpy`
 - :mod:`pytato` (for lazy/deferred evaluation)
 - Debugging
 - Profiling
 
 :mod:`arraycontext` started life as an array abstraction for use with the
-:mod:`meshmode` unstrucuted discretization package.
+:mod:`meshmode` unstructured discretization package.
 
 Design Guidelines
 -----------------