Skip to content

docs: add a connectivity section to the 3.x manual - #1150

Merged
dkropachev merged 1 commit into
scylladb:scylla-3.xfrom
nikagra:connectivity-3x
Sep 28, 2026
Merged

dkropachev merged 1 commit into
scylladb:scylla-3.xfrom
nikagra:connectivity-3x

Conversation

@nikagra

@nikagra nikagra commented Sep 25, 2026 •

Copy link
Copy Markdown

Depends on: nothing (#1155 and #1156 are merged)
Blocks: nothing

People search the 3.x docs for PrivateLink too, and scylla-3.x has only #1081's short note. This adds the 4.x Connectivity section (#1130) to scylla-3.x, where 3.x releases ship. scylla-3.11.5.x, the published 3.x version, only fast-forwards from here, so it reaches /scylla-3.11.5.x/ on the next fast-forward; this replaces #1145.

  • manual/connectivity/: an index, a VPC peering page in 3.x API terms, and a client routes page saying 3.x does not support them (DRIVER-437), with 4.x ≥ 4.19.0.7 as the path
  • 3.x-specific corrections compared with 4.x: withSSL() does no hostname verification, build() does not connect, a wrong local DC fails only on requests, withoutAdvancedShardAwareness() covers NAT and a blocked shard-aware port, and a translator must map each node to its own address:port
  • docs: note that client routes are 4.x-only (DRIVER-1043) #1081's section shrinks to a pointer; its heading is unchanged, so the anchor survives
  • toctree entry after compression/*, using the {eval-rst} fence like the other pages on this branch

Verified with make -C docs test on this branch: exit 0, 0 warnings (the base is also 0), and the new anchor and nav entries render. The driver behaviour described was read from the source, not observed on a cluster. Not checked: search indexing.

Refs: #1121
Jira: DRIVER-1043

🤖 Generated with Claude Code

@coderabbitai

coderabbitai Bot commented Sep 25, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

Next included review available in 46 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Learn how review limits work.

Review configuration:

⚙️ Run configuration

Configuration used: Organization UI

Review profile: QUIET

Plan: Advanced

Run ID: c0a66bca-4080-458b-88df-7ccb68aa1e31

📥 Commits

Reviewing files that changed from the base of the PR and between 5a2f793 and 482a733.

📒 Files selected for processing (5)
  • manual/README.md
  • manual/address_resolution/README.md
  • manual/connectivity/README.md
  • manual/connectivity/client_routes/README.md
  • manual/connectivity/vpc_peering/README.md

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands.

Mirror 4.x's Connectivity section (scylladb#1130) so the 3.x docs answer the
same searches: an index mapping each kind of network to what the driver
needs, a VPC peering / Transit Gateway / direct connection page in 3.x
API terms, and a client routes page stating that 3.x does not support
them and pointing to 4.x. The Address resolution section from scylladb#1081
shrinks to a pointer; its heading is unchanged so the anchor survives.

Co-Authored-By: Claude Opus 5.5 (1M context) <[email protected]>
@dkropachev
dkropachev merged commit f87dded into scylladb:scylla-3.x Sep 28, 2026
20 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants