major additions, not only AI policy, but process, with the goal: permanent, auditable records that can withstand legal and regulatory scrutiny

Author: oberstet

CLAUDE.md

@@ -33,7 +33,7 @@ General mantras this project aims to follow:
 ## Project Overview
 
 The purpose of and an overview of this specific project can be
-found in the top-level [Readme](README.rst).
+found in the top-level [README](README.md).
 
 ## Group of Projects and WAMP
 

README.rst

@@ -0,0 +1 @@
+../README.md

docs/README.md

@@ -132,6 +132,8 @@ def autodoc_skip_member(app, what, name, obj, skip, options):
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
 extensions = [
+    'myst_parser',
+
     # https://sphinx-autoapi.readthedocs.io
     'autoapi.extension',
 
@@ -238,7 +240,6 @@ def autodoc_skip_member(app, what, name, obj, skip, options):
 # a list of builtin themes.
 if sphinx_rtd_theme:
     html_theme = "sphinx_rtd_theme"
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
 else:
     html_theme = "default"
 
@@ -339,10 +340,10 @@ def autodoc_skip_member(app, what, name, obj, skip, options):
    'zlmdb': ('https://zlmdb.readthedocs.io/en/latest/', None),
 }
 
-rst_epilog = """
+rst_epilog = r"""
 .. |ab| replace:: Autobahn
 .. |Ab| replace:: **Autobahn**
-.. |abL| replace:: Autobahn|Python
+.. |abL| replace:: Autobahn\|Python
 .. |AbL| replace:: **Autobahn**\|Python
 .. _Autobahn: http://crossbar.io/autobahn#python
 .. _AutobahnJS: http://crossbar.io/autobahn#js

docs/conf.py

@@ -0,0 +1 @@
+.. mdinclude:: README.md

docs/index.rst

@@ -7,9 +7,10 @@
 backports.tempfile>=1.0
 bumpversion>=0.5.3
 codecov>=2.0.15
-flake8<5
+flake8>=6.0.0
 humanize>=0.5.1
 mypy>=0.610; python_version >= '3.4' and platform_python_implementation != 'PyPy'
+myst_parser>=4.0.1
 passlib
 pep8-naming>=0.3.3
 pip>=9.0.1