Merge pull request #480 from honno/dunder-version-namespace-attr

Include `__array_api_version__` in API specification section

Author: leofang

spec/API_specification/array_api/__init__.py

@@ -12,3 +12,9 @@
 from .statistical_functions import *
 from .utility_functions import *
 from . import linalg
+
+
+__array_api_version__: str = "YYYY.MM"
+"""
+String representing the version of the array API specification which the conforming implementation adheres to.
+"""

spec/API_specification/index.rst

@@ -24,3 +24,4 @@ API specification
    statistical_functions
    type_promotion
    utility_functions
+   version

spec/API_specification/version.rst

@@ -0,0 +1,22 @@
+Version
+=======
+
+    Array API specification for versioning.
+
+A conforming implementation of the array API standard must provide a `__array_api_version__` attribute - see :ref:`api-versioning` for details.
+
+
+Objects in API
+--------------
+
+.. currentmodule:: array_api
+
+..
+  NOTE: please keep the functions in alphabetical order
+
+.. autosummary::
+   :toctree: generated
+   :template: attribute.rst
+   :nosignatures:
+
+   __array_api_version__