docs: add a basic layout for wait strategies in docs

[mdelapenya]

What does this PR do?

It creates a basic layout for the wait strategies in the docs

For that:

• it defines a new nav item under features
• this menu item will be the home for all wait strategies, as a parent
• will add wait strategies specific docs under the new parent nav item
• fixes two consistency issues with methods that were not properly implemented:
  • host_port.go: it's possible now to set the poll internal, as in any other wait strategy
  • sql.go: the WithTimeout function now calls a WithStartupTimeout function, which is consistent with the rest of the wait strategies

I wonder if I should remove the commits for the consistency and send a separate PR, which would be better for the release notes 🤔

Regarding the website, it's important to notice that the golang blocks are automatically pygmented by the existing libraries, so no need to add mkdocs plugins for that.

Why is it important?

It serves as the baseline for adding new docs for the wait strategies (will come in follow-up commits)

It documents the wait strategies, which was missing.

How to test this PR?

Start the local documentation site using the instructions in the docs/contributing_docs.md file

pip install -r requirements.txt
mkdocs serve

Related issues

• Closes Wait strategies: use same WithStartupTimeout methods #314
• Relates Standardize Timeout setter for wait strategies #322, which should be updated resolving conflicts

Follow ups

Automate the local deployment of the docs, using Docker, instead of polluting the local system

[mdelapenya]

Still in draft to validate the initial layout. Will add more commits documenting all the wait strategies, and once there, will mark it as ready for review

[codecov]

Codecov Report

Merging #536 (fb87139) into main (6ee7f6a) will decrease coverage by 0.23%.
The diff coverage is 25.00%.

@@            Coverage Diff             @@
##             main     #536      +/-   ##
==========================================
- Coverage   68.85%   68.61%   -0.24%     
==========================================
  Files          22       22              
  Lines        2148     2154       +6     
==========================================
- Hits         1479     1478       -1     
- Misses        530      537       +7     
  Partials      139      139              

Impacted Files	Coverage Δ
wait/sql.go	22.22% <0.00%> (-0.86%)	⬇️
wait/host_port.go	47.47% <40.00%> (-0.95%)	⬇️
docker.go	70.82% <0.00%> (-0.21%)	⬇️

📣 We’re building smart automated test selection to slash your CI/CD build times. Learn more

[kiview]

Apply suggestions as you see fit. Topics that require a deeper discussion can be discussed outside of this PR.