docs: fix md redirections for multiversion support

[dgarcia360]

Related issue & explanation scylladb/scylladb#23957

This should allow navigation between versions without being redirected to the main index page:

Note: This fix will only apply to future versions unless backported. While backporting may not be worth the effort, it's important to be aware that the issue will remain in older versions

[Bouncheck]

I have tried multiversionpreview limited to 2 last branches and I cannot get it to work. I still get redirected to main page for a version.
Here's what i did, similarly to as instructed in other PR:

• Made local scylla-4.15.0.x and scylla-4.14.1.x branches and also pushed them to my own remote with applied identical change to source_suffix as in PR.
• Returned to local branch with this PR checked out.
• Edited BRANCHES to contain only those two versions, edited smv_remote_whitelist (on separate runs i tried the values None, "", r'^myrepo$')
• Ran make multiversionpreview in docs subdirectory.

No matter the configuration I'm getting redirected from (for example) http://127.0.0.1:5500/scylla-4.14.1.x/manual/api_conventions/index.html
to http://127.0.0.1:5500/stable/index.html when changing version from dropdown menu (4.15.0.x is "stable" in this case)

[Bouncheck]

Regarding the version list: I see that it's severely outdated. I'll try to sort it out separately. Should be as simple as pushing new .x branches and updating the list.

[dgarcia360]

Thanks @Bouncheck for sharing this. After some more testing, I can confirm that it will not fix the issue in versions using the deprecated recommonmark parser. This includes all versions listed in [scylladb_markdown_recommonmark_versions](https://github.com/scylladb/java-driver/blob/scylla-4.x/docs/source/conf.py#L95). It's probably not worth fixing for those versions, will double-check with @annastuchlik

However, we should avoid defining versions released after this commit (24 July 2024) in scylladb_markdown_recommonmark_versions sot that they use the new Markdown parser.

[annastuchlik]

Thanks @Bouncheck for sharing this. After some more testing, I can confirm that it will not fix the issue in versions using the deprecated recommonmark parser. This includes all versions listed in [scylladb_markdown_recommonmark_versions](https://github.com/scylladb/java-driver/blob/scylla-4.x/docs/source/conf.py#L95). It's probably not worth fixing for those versions, will double-check with @annastuchlik

I agree. Let's not fix this for old versions that use recommonmark.

However, we should avoid defining versions released after this commit (24 July 2024) in scylladb_markdown_recommonmark_versions sot that they use the new Markdown parser.

@Bouncheck This is something that needs to be fixed. I'll open a separate issue to do that, and I'll add more explanation there.
If not fixed, redirections fixed with this PR won't work on any of the Java Driver versions (but it's just one of many reasons to avoid configuring new versions to use the deprecated).

Next steps:

• Remove the new versions from the scylladb_markdown_recommonmark_versions list.
• Merge this PR.

Redirections will be working for the new versions that are NOT listed with scylladb_markdown_recommonmark_versions.