doc: nitpick fixes; hints at sphinx.testing

Author: ankostis

docs/source/arch.rst

@@ -72,7 +72,7 @@ Architecture
         There are 2 ways to feed the `solution` back into the same `pipeline`:
 
         * by reusing the pre-compiled `plan` (coarse-grained), or
-        * by using the ``compute(recalculate_from=...)`` argument (fine-grained),
+        * by using the ``compute(recompute_from=...)`` argument (fine-grained),
 
         as described in :ref:`recompute` tutorial section.
 

graphtik/jetsam.py

@@ -1,6 +1,8 @@
 # Copyright 2019-2020, Kostis Anagnostopoulos;
 # Licensed under the terms of the Apache License, Version 2.0. See the LICENSE file associated with the project for terms.
-""":term:`jetsam` utility for annotating exceptions from ``locals()``.
+""":term:`jetsam` utility for annotating exceptions from ``locals()`` like :pep:`678`
+
+PY3.11 exception-notes.
 
 .. doctest::
     :hide:

graphtik/modifier.py

@@ -1138,7 +1138,7 @@ def sfxed(
         of the function.
     :param sfx0:
         the 1st (arbitrary object) sideffect marked as "acting" on the `dependency`.
-    :param sfx0:
+    :param sfx_list:
         more (arbitrary object) sideffects (like the `sfx0`)
     :param keyword:
         the name for the function argument it corresponds.

test/sphinxext/test_directive.py

@@ -1,3 +1,12 @@
+"""
+Pytest-ing sphinx directives is `yet undocumented
+<https://github.com/sphinx-doc/sphinx/issues/7008>`_
+and as explained also in `this sourceforge <>`_ thread,
+you may learn more from the `test-cases in the *sphinx* sources
+<https://github.com/sphinx-doc/sphinx/blob/master/tests/test_ext_doctest.py>`_
+or `similar projects
+<https://github.com/pauleveritt/customizing_sphinx/blob/master/tests/integration/test_directive.py>`_.
+"""
 import os.path as osp
 import re
 import xml.etree