From 3b563315792d7f5494e3a134ecbfe01593eb09ec Mon Sep 17 00:00:00 2001
From: David Garcia <hi@davidgarcia.dev>
Date: Mon, 18 Dec 2023 21:32:11 +0000
Subject: [PATCH 1/2] docs: update theme 1.6

---
 docs/Makefile       |  7 +------
 docs/pyproject.toml | 17 +++++++++--------
 docs/source/conf.py | 15 +++++++--------
 3 files changed, 17 insertions(+), 22 deletions(-)

diff --git a/docs/Makefile b/docs/Makefile
index 0e2f22c97..475e4ba6d 100644
--- a/docs/Makefile
+++ b/docs/Makefile
@@ -1,6 +1,6 @@
 # You can set these variables from the command line.
 POETRY        = poetry
-SPHINXOPTS    =
+SPHINXOPTS    = -j auto
 SPHINXBUILD   = $(POETRY) run sphinx-build
 PAPER         =
 BUILDDIR      = _build
@@ -14,11 +14,6 @@ ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) $(S
 TESTSPHINXOPTS  = $(ALLSPHINXOPTS) -W --keep-going
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) $(SOURCEDIR)
 
-# Windows variables
-ifeq ($(OS),Windows_NT)
-    POETRY = $(APPDATA)\Python\Scripts\poetry
-endif
-
 .PHONY: all
 all: dirhtml
 
diff --git a/docs/pyproject.toml b/docs/pyproject.toml
index 1d121ae65..89c49e7bb 100644
--- a/docs/pyproject.toml
+++ b/docs/pyproject.toml
@@ -5,16 +5,17 @@ version = "0.1"
 authors = ["ScyllaDB Documentation Contributors"]
 
 [tool.poetry.dependencies]
-breathe="4.33.1"
-python = "^3.7"
-pyyaml = "6.0"
-pygments = "2.2.0"
+breathe="4.35.0"
+python = "^3.9"
+pyyaml = "6.0.1"
+pygments = "2.15.1"
 recommonmark = "0.7.1"
-sphinx-scylladb-theme = "~1.2.1"
-sphinx-sitemap = "2.1.0"
+redirects_cli ="~0.1.2"
+sphinx-scylladb-theme = "~1.6.1"
+sphinx-sitemap = "2.5.1"
 sphinx-autobuild = "2021.3.14"
-Sphinx = "4.3.2"
-sphinx-multiversion-scylla = "~0.2.11"
+Sphinx = "7.2.6"
+sphinx-multiversion-scylla = "~0.3.1"
 [tool.poetry.dev-dependencies]
 pytest = "5.2"
 
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 39cf254bd..f403707c1 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -7,7 +7,7 @@
 from recommonmark.parser import CommonMarkParser
 from sphinx_scylladb_theme.utils import multiversion_regex_builder
 
-# -- General configuration ------------------------------------------------
+# -- General configuration
 
 sys.path.insert(0, os.path.abspath('../../'))
 
@@ -77,7 +77,7 @@
 # If true, `todo` and `todoList` produce output, else they produce nothing.
 todo_include_todos = True
 
-# -- Options for not found extension -------------------------------------------
+# -- Options for not found extension
 
 # Template used to render the 404.html generated by this extension.
 notfound_template =  '404.html'
@@ -85,13 +85,12 @@
 # Prefix added to all the URLs generated in the 404 page.
 notfound_urls_prefix = ''
 
-# -- Options for redirect extension ---------------------------------------
+# -- Options for redirect extension
 
 # Read a YAML dictionary of redirections and generate an HTML file for each
 redirects_file = "_utils/redirections.yaml"
 
-# -- Options for multiversion extension ----------------------------------
-
+# -- Options for multiversion extension
 # Whitelist pattern for tags
 smv_tag_whitelist = multiversion_regex_builder(TAGS)
 # Whitelist pattern for branches
@@ -107,7 +106,7 @@
 # Format for versioned output directories inside the build directory
 smv_outputdir_format = '{ref.name}'
 
-# -- Options for Doxygen (API Reference) ---------------------------------
+# -- Options for Doxygen (API Reference)
 breathe_projects = {
 	'API': "../../doxygen/xml/"
 }
@@ -139,11 +138,11 @@ def generate_doxygen(app):
     DOXYGEN_XML_DIR = breathe_projects[breathe_default_project]
     _generate_doxygen_rst(DOXYGEN_XML_DIR, app.builder.srcdir + '/api')	
 
-# -- Options for sitemap extension ---------------------------------------
+# -- Options for sitemap extension
 
 sitemap_url_scheme = 'stable/{link}'
 
-# -- Options for HTML output ----------------------------------------------
+# -- Options for HTML output
 
 # The theme to use for HTML and HTML Help pages.  See the documentation for
 # a list of builtin themes.

From 18613e2a44f3aeea9ab9e43972b5480358b06e67 Mon Sep 17 00:00:00 2001
From: David Garcia <hi@davidgarcia.dev>
Date: Mon, 18 Dec 2023 21:39:39 +0000
Subject: [PATCH 2/2] docs: rm warning

---
 docs/source/conf.py | 6 ------
 1 file changed, 6 deletions(-)

diff --git a/docs/source/conf.py b/docs/source/conf.py
index 345a778a1..79eff2918 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -59,12 +59,6 @@
 copyright = str(date.today().year) + ', ScyllaDB. All rights reserved.'
 author = u'Scylla Project Contributors'
 
-# The language for content autogenerated by Sphinx. Refer to documentation
-# for a list of supported languages.
-#
-# This is also used if you do content translation via gettext catalogs.
-# Usually you set "language" from the command line for these cases.
-language = None
 
 # List of patterns, relative to source directory, that match files and
 # directories to ignore when looking for source files.