From: Matthew Watkins <mwatkins@linuxfoundation.org>
Date: Wed, 4 Mar 2026 16:59:37 +0000 (+0000)
Subject: Docs: Replace blockdiag/seqdiag with Mermaid
X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=864881720a1a82d1b2d694c547ab82b4584cdc69;p=so.git

Docs: Replace blockdiag/seqdiag with Mermaid

Replace the abandoned sphinxcontrib-blockdiag and sphinxcontrib-seqdiag
Sphinx extensions with sphinxcontrib-mermaid in docs configuration.

None of the documentation in this repository uses blockdiag or seqdiag
directives; this is a config-only cleanup.

Issue-ID: CIMAN-33
Change-Id: I5b674251112adad1162daddf08e5a60c3c1b755d
Signed-off-by: Claude <noreply@anthropic.com>
Signed-off-by: Matthew Watkins <mwatkins@linuxfoundation.org>
---

diff --git a/docs/conf.py b/docs/conf.py
index cc83cd4ce7..6ab5c9c387 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -21,8 +21,7 @@ html_show_sphinx = False
 extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.graphviz',
-    'sphinxcontrib.blockdiag',
-    'sphinxcontrib.seqdiag',
+    'sphinxcontrib.mermaid',
     'sphinxcontrib.plantuml'
 ]
 
diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt
index a72d6013ac..62bbe24f02 100644
--- a/docs/requirements-docs.txt
+++ b/docs/requirements-docs.txt
@@ -1,7 +1,6 @@
 sphinx>=4.2.0  # BSD
 sphinx-rtd-theme>=1.0.0  # MIT
-sphinxcontrib-blockdiag  # BSD
-sphinxcontrib-seqdiag # BSD
+sphinxcontrib-mermaid>=1.0.0
 sphinxcontrib-spelling
 sphinxcontrib-plantuml
 six
diff --git a/docs/tox.ini b/docs/tox.ini
index 358f8d008d..2bb93c44a0 100644
--- a/docs/tox.ini
+++ b/docs/tox.ini
@@ -4,7 +4,7 @@ envlist = docs,docs-linkcheck,docs-spellcheck
 skipsdist = true
 
 [testenv:docs]
-basepython = python3.8
+basepython = python3.13
 deps =
     -r{toxinidir}/requirements-docs.txt
     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
@@ -17,7 +17,7 @@ allowlist_externals =
     sh
 
 [testenv:docs-linkcheck]
-basepython = python3.8
+basepython = python3.13
 deps =
     -r{toxinidir}/requirements-docs.txt
     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
@@ -26,7 +26,7 @@ commands = echo "Link Checking not enforced"
 allowlist_externals = echo
 
 [testenv:docs-spellcheck]
-basepython = python3.8
+basepython = python3.13
 deps =
     -r{toxinidir}/requirements-docs.txt
     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master