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: Iebd4d49658940c3b637dc338581027610e2f6c2e
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 ab8f729..3831e05 100644 (file)
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -19,8 +19,7 @@ html_show_sphinx = False
 extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.graphviz',
 extensions = [
     'sphinx.ext.intersphinx',
     'sphinx.ext.graphviz',

-    'sphinxcontrib.blockdiag',
-    'sphinxcontrib.seqdiag',
+    'sphinxcontrib.mermaid',

     'sphinxcontrib.plantuml'
 ]
 
     'sphinxcontrib.plantuml'
 ]
 

diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt
index a72d601..62bbe24 100644 (file)
--- 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
 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
 sphinxcontrib-spelling
 sphinxcontrib-plantuml
 six

diff --git a/docs/tox.ini b/docs/tox.ini
index 643da68..aed203c 100644 (file)
--- a/docs/tox.ini
+++ b/docs/tox.ini
@@ -4,28 +4,25 @@ envlist = docs,docs-linkcheck,docs-spellcheck
 skipsdist = true
 
 [testenv:docs]
 skipsdist = true
 
 [testenv:docs]

-basepython = python3.8
+basepython = python3.13

 deps =
     -r{toxinidir}/requirements-docs.txt
 deps =
     -r{toxinidir}/requirements-docs.txt

-    -chttps://releases.openstack.org/constraints/upper/yoga

     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
     sphinx-build -W -q -b html -n -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/html
 
 [testenv:docs-linkcheck]
     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
     sphinx-build -W -q -b html -n -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/html
 
 [testenv:docs-linkcheck]

-basepython = python3.8
+basepython = python3.13

 deps =
     -r{toxinidir}/requirements-docs.txt
 deps =
     -r{toxinidir}/requirements-docs.txt

-    -chttps://releases.openstack.org/constraints/upper/yoga

     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
     sphinx-build -W -q -b linkcheck -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/linkcheck
 
 [testenv:docs-spellcheck]
     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
     sphinx-build -W -q -b linkcheck -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/linkcheck
 
 [testenv:docs-spellcheck]

-basepython = python3.8
+basepython = python3.13

 deps =
     -r{toxinidir}/requirements-docs.txt
 deps =
     -r{toxinidir}/requirements-docs.txt

-    -chttps://releases.openstack.org/constraints/upper/yoga

     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
     sphinx-build -q -b spelling -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/spellcheck
     -chttps://git.onap.org/doc/plain/etc/upper-constraints.onap.txt?h=master
 commands =
     sphinx-build -q -b spelling -d {envtmpdir}/doctrees {toxinidir} {toxinidir}/_build/spellcheck