docs: enable tooltips

[dgarcia360]

Related issue #873

Updates the docs theme to the latest version to enable tooltips and modifies the db_options.tmpl to show the new role in action.

How to test

1. Clone this PR.

2. Build the docs.

3. Open http://127.0.0.1:5500/reference/configuration-parameters/ and preview the tooltips:

   

[scylladb-promoter]

Docs Preview 📖

Docs Preview for this pull request is available here

Changed Files:

Note: This preview will be available for 30 days and will be automatically deleted after that period. You can manually trigger a new build by committing changes.

[annastuchlik]

Looks great.

[annastuchlik]

@tzach Please have a look.

[tzach]

I love the tooltip feature, but in this case (Liveness) the tip is too long, and hard to read.
Maybe less text, bigger font, will help

[annastuchlik]

I love the tooltip feature, but in this case (Liveness) the tip is too long, and hard to read. Maybe less text, bigger font, will help

@tzach We're on the same page here. Tooltips that are too long are hard to follow, and we should avoid lengthy descriptions. This PR only demonstrates how the tooltip feature works — we need to adjust the tooltip content while using the feature.

Regarding the bigger font, we need to see how it would work. Perhaps increasing spacing would do?
Thanks for your feedback. We'll address it in a follow-up PR.

[annastuchlik]

@denesb Please merge.

[avikivity]

Is this part of the commit or accidental?

[dgarcia360]

It's part of the commit (update to the latest version). We now include poetry.lock in all projects (context).

Unless contributors manually run make update, the poetry.lock file will remain static and won’t be changed in other pull requests.

[denesb]

In the future, consider doing this as a separate PR or at least as a separate commit, so it doesn't get lost in the noise.