WIP

docs/conf.py

@@ -92,7 +92,7 @@ exclude_patterns = ['_build']
 # show_authors = False
 
 # The name of the Pygments (syntax highlighting) style to use.
-pygments_style = 'sphinx'
+# pygments_style = "material"
 
 # A list of ignored prefixes for module index sorting.
 # modindex_common_prefix = []
@@ -105,19 +105,20 @@ pygments_style = 'sphinx'
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.
-try:
-    import sphinx_rtd_theme
-
-    html_theme = "sphinx_rtd_theme"
-
-    html_theme_path = [sphinx_rtd_theme.get_html_theme_path()]
-except:
-    pass
+html_theme = "furo"
 
 # Theme options are theme-specific and customize the look and feel of a theme
 # further.  For a list of options available for each theme, see the
 # documentation.
-# html_theme_options = {}
+html_theme_options = {
+    "announcement": "<b>This is the WIP documentation for Connexion 3.0, which is in alpha. "
+                    "Find the stable version "
+                    "<a href=https://connexion.readthedocs.io/en/stable/>here</a>.</b>",
+    "light_css_variables": {
+        "color-announcement-background": "#ff5252",
+        "color-announcement-text": "#ffffff"
+    }
+}
 
 # Add any paths that contain custom themes here, relative to this directory.
 # html_theme_path = []

docs/index.rst

@@ -3,13 +3,6 @@
    You can adapt this file completely to your liking, but it should at least
    contain the root `toctree` directive.
 
-.. warning::
-
-    This is the WIP documentation for Connexion 3.0 which is currently in alpha. You might want to
-    read the documentation for the latest `stable version`_ instead.
-
-    If you want to try out Connexion 3.0, refer to the :ref: `v3`_ section.
-
 Welcome to Connexion's documentation!
 =====================================
 

docs/v3.rst

@@ -1,10 +1,3 @@
-.. warning::
-
-    Do not use Connexion 3.0 in production yet!
-
-    Connexion 3.0 is currently available in alpha to give users the ability to test it and provide
-    feedback while we further polish the codebase and update the documentation.
-
 Getting started with Connexion 3.0
 ==================================
 

pyproject.toml

@@ -79,7 +79,7 @@ pytest-cov = "~2.12.1"
 sphinx = "5.3.0"
 sphinx_copybutton = "0.5.2"
 sphinx_design = "0.4.1"
-sphinx-rtd-theme = "1.2.0"
+furo = "2023.03.27"
 
 [build-system]
 requires = ["poetry-core>=1.2.0"]