temporary changes

rebase or delete later on

Author: Bouncheck

docs/Makefile

@@ -10,7 +10,7 @@ SOURCEDIR     = _source
 PAPEROPT_a4     = -D latex_paper_size=a4
 PAPEROPT_letter = -D latex_paper_size=letter
 ALLSPHINXOPTS   = -d $(BUILDDIR)/doctrees $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) $(SOURCEDIR)
-TESTSPHINXOPTS  = $(ALLSPHINXOPTS) -W --keep-going
+TESTSPHINXOPTS  = $(ALLSPHINXOPTS) -W --keep-going -v
 I18NSPHINXOPTS  = $(PAPEROPT_$(PAPER)) $(SPHINXOPTS) $(SOURCEDIR)
 
 .PHONY: all

docs/pyproject.toml

@@ -8,6 +8,7 @@ authors = ["Java Driver Contributors"]
 python = "^3.9"
 pyyaml = "6.0.1"
 pygments = "2.15.1"
+recommonmark = "0.7.1"
 redirects_cli ="~0.1.3"
 sphinx-scylladb-theme = "~1.7.2"
 sphinx-sitemap = "2.5.1"

docs/source/conf.py

@@ -99,6 +99,7 @@
     'scylla-4.13.0.x',
     'scylla-4.14.1.x',
     'scylla-4.15.0.x',
+    'scylla-4.18.1.x'
 ]
 suppress_warnings = ["ref.any", "myst.header","myst.xref_missing","autosectionlabel"]
 
@@ -186,5 +187,9 @@ def setup(app):
         r'java-driver.docs.scylladb.com\/(.*?)\/': "java-driver.docs.scylladb.com/" + current_slug + "/"
     }
     app.add_config_value('replacements', replacements, True)
+    app.add_config_value('recommonmark_config', {
+        'enable_eval_rst': True,
+        'enable_auto_toc_tree': False,
+    }, True)
     app.connect('source-read', replace_relative_links)
     app.connect('build-finished', redirect_api_page_to_javadoc)