Skip to content

Conversation

@aimurphy
Copy link
Contributor

@aimurphy aimurphy commented Jan 22, 2026

  • Remove the support-url attribute because it isn't used.
  • Make it easier to read the supported Python versions for cqlsh, and specify 2.7.12+ because of TLS support.
  • Remove two links to a support portal article.
    • Only one was on a published page.
    • The article relates to the standalone cqlsh, and one of the resolutions suggests changing the cqlsh package.
    • Instead, I added the "check TLS support" command to the Astra CLI docs, and mentioned that the user can use venv or symlink as long as the supported Python version is available in the PATH.
    • Preview: cqlsh prerequisites

@aimurphy aimurphy self-assigned this Jan 22, 2026
@plpesvc-ds

This comment has been minimized.

@eric-schneider
Copy link
Contributor

I'd like @toptobes to review the Python-related changes just to double-check that everything looks right. How the CLI finds a version of Python was something that was discussed in during reviews of the 1.0 overhaul of the docs.

@toptobes
Copy link
Collaborator

This version doesn't need to be your system's default Python version as long as it's available in the PATH.

For example, you can use a virtual environment or symbolic links to add a supported Python version without changing your system's default version.

Imo the first paragraph makes it pretty clear but then the second paragraph is a little confusing in that you may think you still need to set python to be the default version via venv or something

To be clear, as long as the python3.11 command or python3.10 or something is a valid command then you'd be good to go. I think the first paragraph supports this, but the second muddies it.

@aimurphy
Copy link
Contributor Author

Thanks for the input - I removed the confusing sentence

Copy link
Contributor

@eric-schneider eric-schneider left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Awesome! Thank you!

@aimurphy aimurphy merged commit e6c3b11 into main Jan 27, 2026
1 check passed
@aimurphy aimurphy deleted the doc-5616 branch January 27, 2026 12:54
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.

5 participants