doc: readd MatrixKind doc

Author: james-d-mitchell

docs/source/data-structures/elements/matrix/matrix.rst

@@ -150,6 +150,7 @@ MatrixKind
 ----------
 
 .. autoclass:: MatrixKind
+    :show-inheritance:
 
 ..
     TODO later summary

docs/source/install.rst

@@ -5,7 +5,7 @@
 
     The full license is in the file LICENSE, distributed with this software.
 
-.. |libsemigroups-pybind11-version| replace:: 1.0.0
+|libsemigroups-pybind11-version| replace:: 1.0.0
 
 Installation
 ============

src/libsemigroups_pybind11/matrix.py

@@ -36,9 +36,52 @@
 # the underscore prefix stops this from appearing in the doc of the
 # "matrix" submodule
 class _MatrixKind(_Enum):
-    """"""
+    """
+
+    This enum contains values that can be used to describe the type of semiring
+    over which a :any:`Matrix` is defined.
+
+    .. py:attribute:: MatrixKind.Boolean
+        :value: <MatrixKind.Boolean: 0>
+
+        For matrices over the Boolean semiring.
+
+    .. py:attribute:: MatrixKind.Integer
+        :value: <MatrixKind.Integer: 1>
+
+        For matrices over the usual ring of integers.
+
+    .. py:attribute:: MatrixKind.MaxPlus
+        :value: <MatrixKind.MaxPlus: 2>
+
+        For matrices over the max-plus semiring.
+
+    .. py:attribute:: MatrixKind.MinPlus
+        :value: <MatrixKind.MinPlus: 3>
 
-    # pylint: disable=invalid-name
+        For matrices over the min-plus semiring.
+
+    .. py:attribute:: MatrixKind.ProjMaxPlus
+        :value: <MatrixKind.ProjMaxPlus: 4>
+
+        For projective matrices over the max-plus semiring.
+
+    .. py:attribute:: MatrixKind.MaxPlusTrunc
+        :value: <MatrixKind.MaxPlusTrunc: 5>
+
+        For matrices over the truncated max-plus semiring.
+
+    .. py:attribute:: MatrixKind.MinPlusTrunc
+        :value: <MatrixKind.MinPlusTrunc: 6>
+
+        For matrices over the truncated min-plus semiring.
+
+    .. py:attribute:: MatrixKind.NTP
+        :value: <MatrixKind.NTP: 7>
+
+        For matrices over the semiring of natural numbers quotiented by `t
+        = t + p`.
+    """
 
     Boolean = 0
     Integer = 1