docs: add toolchain

[dgarcia360]

Closes #303

Motivation

Adds a sample docs site to the project & autogenerates docs from jsdoc.

How to test

1. Make sure you meet the prerequisites.
2. Clone the PR.
3. Go to the docs folder: cd docs
4. Build the docs: make preview
5. The site should render at http://127.0.0.1:5500/
6. Open http://127.0.0.1:5500/api to preview the API refernece.

Next steps after merging

1. Add content to the site (maintainers)
2. Request zendesk tag for this project, optional (@annastuchlik)
3. Request subdomain to IT (@annastuchlik, @dgarcia360 )
4. Configure GitHub Pages (maintainers)

Could you please enable the following option?

In the repository’s Settings, navigate to the Pages section and select GitHub Actions as the deployment source.

Thanks!

[adespawn]

I can see the site building correctly, but it seems to contain only API reference - the documentation (./doc/src) is missing

[adespawn]

Will this file need to be manually updated when changing README?

[dgarcia360]

Yes, but it is placeholder content right now. You'll decide what to document in the frontpage with @annastuchlik (#401 (comment))

[annastuchlik]

I can see the site building correctly, but it seems to contain only API reference - the documentation (./doc/src) is missing

This is expected. This PR just adding the automation part, including the API docs.
Let's work on the actual docs in a follow-up PR. We need to decide what to expose to the customer and how to organize the content.

[wprzytula]

🔧 Please use uv, just as @Lorak-mmk did in Rust Driver: scylladb/scylla-rust-driver#1528

[dgarcia360]

It has broader implications since we have this toolchain installed across 15+ docs projects and we have to maintain it. If it makes sense, we'll do it as a follow-up PR and help all projects migrate to uv at once.

We're now upgrading the theme to support Python 3.14 & Sphinx 9. Might be the right time to make the switch (main benefit is uv is 10–100x faster than poetry for dependency resolution and installs). @annastuchlik, thoughts?

[Lorak-mmk]

Imo main benefit is that uv works, and is not a pain to work with, as compared to any other Python package / project manager.
Some projects already migrated:

• Rust Driver: Docs: Migrate to uv scylla-rust-driver#1528
• Python Driver: Set docs workflows in order python-driver#544
• cpp-rs Driver: Migrate docs to UV cpp-rs-driver#410

[adespawn]

Could you please enable the following option?

This option was already enabled

[annastuchlik]

Can this PR be merged now?