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)

manual/README.md

@@ -34,7 +34,7 @@ Common topics:
 * [Case sensitivity](case_sensitivity/)
 * [OSGi](osgi/)
 
-```eval_rst
+```{eval-rst}
 .. toctree::
    :hidden:
    :glob:

manual/core/README.md

@@ -351,7 +351,7 @@ for (ColumnDefinitions.Definition definition : row.getColumnDefinitions()) {
 
 [CASSANDRA-10145]: https://issues.apache.org/jira/browse/CASSANDRA-10145
 
-```eval_rst
+```{eval-rst}
 .. toctree::
    :hidden:
    :glob:

manual/core/configuration/README.md

@@ -556,7 +556,7 @@ config.getDefaultProfile().getInt(MyCustomOption.AWESOMENESS_FACTOR);
 [HOCON]: https://github.com/typesafehub/config/blob/master/HOCON.md
 [API conventions]: ../../api_conventions
 
-```eval_rst
+```{eval-rst}
 .. toctree::
    :hidden:
    :glob:

manual/core/metadata/README.md

@@ -79,7 +79,7 @@ refreshed. See the [Performance](../performance/#debouncing) page for more detai
 [Metadata]:                                     https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/api/core/metadata/Metadata.html
 [Node]:                                         https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/api/core/metadata/Node.html
 
-```eval_rst
+```{eval-rst}
 .. toctree::
    :hidden:
    :glob:

manual/core/statements/README.md

@@ -83,7 +83,7 @@ can create execution profiles to capture common combinations of those options).
 [execute]:          https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/api/core/session/Session.html#execute-com.datastax.oss.driver.api.core.cql.Statement-
 [executeAsync]:     https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/api/core/session/Session.html#executeAsync-com.datastax.oss.driver.api.core.cql.Statement-
 
-```eval_rst
+```{eval-rst}
 .. toctree::
    :hidden:
    :glob:

manual/developer/README.md

@@ -37,7 +37,7 @@ from lowest to highest level:
 
 If you're reading this on GitHub, the `.nav` file in each directory contains a suggested order.
 
-```eval_rst
+```{eval-rst}
 .. toctree::
    :hidden:
    :glob:

manual/developer/common/README.md

@@ -27,7 +27,7 @@ This covers utilities or concept that are shared throughout the codebase:
 * the [event bus](event_bus/) is used to decouple some of the internal components through
   asynchronous messaging.
 
-```eval_rst
+```{eval-rst}
 .. toctree::
    :hidden:
    :glob: