New: Collapsible sections in Docs

conf.py

@@ -40,7 +40,9 @@
     "github",
     "seo",
     "components",
-    "sitemap",
+    "sitemap",    
+
+    'sphinx_toolbox.collapse',
 ]
 
 # Add any paths that contain templates here, relative to this directory.

guides/contributing.rst

@@ -251,6 +251,47 @@ adhere to the following order:
 
       Note that a blank line is *required* after every ``code-block`` directive.
 
+- **Collapsible section**: To add a collapsible section, use the ``collapse`` directive:
+
+  .. code-block:: rst
+
+      .. collapse:: Details
+
+          Something small enough to escape casual notice.
+
+      .. collapse:: Open
+
+          :open:
+
+          This section is open by default.
+
+      .. collapse:: A long code block
+
+          .. code-block:: python
+
+              print("Not really")
+
+  .. collapse:: Details
+
+      Something small enough to escape casual notice.
+
+  .. collapse:: Open
+
+      :open:
+
+      This section is open by default.
+
+  .. collapse:: A long code block
+
+      .. code-block:: python
+
+          print("Not really")
+
+  .. note::
+
+      Note that a blank line is *required* after every ``collapse`` directive.
+
+
 - **Images**: Use the ``figure`` directive to display an image:
 
   .. code-block:: rst

requirements.txt

@@ -1,2 +1,3 @@
 sphinx==5.0.1
 sphinx-autobuild==2021.3.14
+sphinx-toolbox==3.8.0