docs: refactor kubernetes documentation

[lukasmetzner]

Refactors the csi-driver documentation to align with https://diataxis.fr.

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 72.17%. Comparing base (22f4b1a) to head (e67ef5d).
⚠️ Report is 2 commits behind head on main.

Additional details and impacted files

@@            Coverage Diff             @@
##             main    #1385      +/-   ##
==========================================
+ Coverage   71.97%   72.17%   +0.19%     
==========================================
  Files          17       17              
  Lines        1520     1520              
==========================================
+ Hits         1094     1097       +3     
+ Misses        338      336       -2     
+ Partials       88       87       -1     

Flag	Coverage Δ
e2e-controller	56.90% <ø> (+0.19%)	⬆️
e2e-node	56.90% <ø> (+0.19%)	⬆️
integration	3.19% <ø> (ø)
unit	40.85% <ø> (ø)

Flags with carried forward coverage won't be shown. Click here to find out more.

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[jooola]

Did a first pass, thanks for pushing for this ❤️!

[jooola]

I'd argue this is a tutorial, but I don't mind having it as guide.

[lukasmetzner]

I shortened it a bit in 9eb7706.

I also think it is not a good idea to have a PVC example creation there, as this directly introduces some costs to the customer. Verifying the StorageClass should be fine. Folks should be familiar with creating a PVC from a StorageClass.

[lukasmetzner]

I want to add a few more things here.