From: Matthew Watkins <mwatkins@linuxfoundation.org>
Date: Tue, 27 Jan 2026 15:16:37 +0000 (+0000)
Subject: Chore: Remove broken sphinxcontrib-swaggerdoc module
X-Git-Url: https://gerrit.onap.org/r/gitweb?a=commitdiff_plain;h=dffda5227e7e3b90168c631efd3fd6c9a6ce259c;p=ccsdk%2Fcds.git

Chore: Remove broken sphinxcontrib-swaggerdoc module

This Python module is no longer maintained and will not allow us to
update to more modern Python versions in the docs jobs.

Issue-ID: CIMAN-33
Change-Id: I97f076a14f6ac938cdd1fc11d320d04c6ec97b82
Signed-off-by: Matthew Watkins <mwatkins@linuxfoundation.org>
---

diff --git a/docs/api-reference/bp-processor.rst b/docs/api-reference/bp-processor.rst
index efb56b117..cd9d671b4 100644
--- a/docs/api-reference/bp-processor.rst
+++ b/docs/api-reference/bp-processor.rst
@@ -153,10 +153,7 @@ HTTP Status 202 OK
 API Reference
 --------------
 
-.. warning::
-   In the used Sphinx plugin `sphinxcontrib-swaggerdoc` some information of the swagger file is not
-   rendered completely, e.g. the request body. Use your favorite Swagger Editor and paste the swagger file
-   to get a complete view of the API reference, e.g. on https://editor.swagger.io/.
+
 
 .. swaggerv2doc:: media/cds-bp-processor-api-swagger.json
 
diff --git a/docs/conf.py b/docs/conf.py
index 8ffa7a73d..a6c20e463 100644
--- a/docs/conf.py
+++ b/docs/conf.py
@@ -21,7 +21,6 @@ extensions = [
     'sphinx.ext.graphviz',
     'sphinxcontrib.blockdiag',
     'sphinxcontrib.seqdiag',
-    'sphinxcontrib.swaggerdoc',
     'sphinxcontrib.plantuml',
     'sphinx_tabs.tabs'
 ]
diff --git a/docs/requirements-docs.txt b/docs/requirements-docs.txt
index 915e33c0c..e9abe2667 100644
--- a/docs/requirements-docs.txt
+++ b/docs/requirements-docs.txt
@@ -2,7 +2,6 @@ sphinx>=4.2.0  # BSD
 sphinx-rtd-theme>=1.0.0  # MIT
 sphinxcontrib-blockdiag  # BSD
 sphinxcontrib-seqdiag # BSD
-sphinxcontrib-swaggerdoc
 sphinxcontrib-spelling
 sphinxcontrib-plantuml
 sphinx-tabs