From 488d5e3e525d765496dc8a259c13aa6938610f9b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wojciech=20B=C4=85czkowski?= Date: Tue, 27 May 2025 12:14:27 +0200 Subject: [PATCH 1/2] Fix broken links in reconnection manual Those links redirect to internal API which is not a part of the generated javadoc, leading to 404 on visit. Instead redirect to code on github. --- manual/core/reconnection/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/manual/core/reconnection/README.md b/manual/core/reconnection/README.md index 3eb6dad9c05..414b9d8b5e8 100644 --- a/manual/core/reconnection/README.md +++ b/manual/core/reconnection/README.md @@ -103,7 +103,7 @@ Note that the session is not accessible until it is fully ready: the `CqlSession call — or the future returned by `buildAsync()` — will not complete until the connection was established. -[ConstantReconnectionPolicy]: https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/internal/core/connection/ConstantReconnectionPolicy.html +[ConstantReconnectionPolicy]: https://github.com/scylladb/java-driver/blob/scylla-4.x/core/src/main/java/com/datastax/oss/driver/internal/core/connection/ConstantReconnectionPolicy.java [DriverContext]: https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/api/core/context/DriverContext.html -[ExponentialReconnectionPolicy]: https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/internal/core/connection/ExponentialReconnectionPolicy.html +[ExponentialReconnectionPolicy]: https://github.com/scylladb/java-driver/blob/scylla-4.x/core/src/main/java/com/datastax/oss/driver/internal/core/connection/ExponentialReconnectionPolicy.java [ReconnectionPolicy]: https://docs.datastax.com/en/drivers/java/4.17/com/datastax/oss/driver/api/core/connection/ReconnectionPolicy.html From 61f29559d3b401bc835a856c7f1ce1294cb312c4 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Wojciech=20B=C4=85czkowski?= Date: Tue, 27 May 2025 12:16:10 +0200 Subject: [PATCH 2/2] Add replacement patterns to docs/conf.py Some of the links in documentation lead to datastax repositories. This change adds patterns that should cover any links to classes or directories of the codebase and make them point to scylladb fork instead. --- docs/source/conf.py | 6 +++++- 1 file changed, 5 insertions(+), 1 deletion(-) diff --git a/docs/source/conf.py b/docs/source/conf.py index ce2bb388069..5af11e9699e 100644 --- a/docs/source/conf.py +++ b/docs/source/conf.py @@ -184,7 +184,11 @@ def setup(app): current_slug = os.getenv("SPHINX_MULTIVERSION_NAME", "stable") replacements = { r'docs.datastax.com/en/drivers/java\/(.*?)\/': "java-driver.docs.scylladb.com/" + current_slug + "/api/", - r'java-driver.docs.scylladb.com\/(.*?)\/': "java-driver.docs.scylladb.com/" + current_slug + "/" + r'java-driver.docs.scylladb.com\/(.*?)\/': "java-driver.docs.scylladb.com/" + current_slug + "/", + r'github.com\/apache\/cassandra-java-driver\/blob\/4.x\/': "github.com/scylladb/java-driver/blob/scylla-4.x/", + r'github.com\/apache\/cassandra-java-driver\/tree\/4.x\/': "github.com/scylladb/java-driver/tree/scylla-4.x/", + r'github.com\/datastax\/java-driver\/blob\/4.x\/': "github.com/scylladb/java-driver/blob/scylla-4.x/", + r'github.com\/datastax\/java-driver\/tree\/4.x\/': "github.com/scylladb/java-driver/tree/scylla-4.x/" } app.add_config_value('replacements', replacements, True) app.connect('source-read', replace_relative_links)