Resolve #869

[pBouillon]

Rework the documentation page

Fix the docs as described by the discussion in #869

[linkdotnet]

Hey @pBouillon thanks for handing in that nice PR.
Just a side note from my side. It seems that you branched off from main and not stable. That is why we see some merge commits and additional changes.

Would it be possible to branch of ffrom stable? Or alternatively (depending on how much of a git pro you are), you can do this (pretending you are on your branch):

git pull
git rebase --onto origin/stable origin/main
git push --force-with-lease

That commands rebases the from main to stable. Please do this only if you are confident with git.

[pBouillon]

Hey @linkdotnet!

Thanks for the hint, I misunderstood the issue and thought that I should target stable but didn't get that it implied starting from it too, I'll fix that 😄

[pBouillon]

I did not felt confident enough with the git commands you suggested so I did a separate PR to change the source and target branches on #877

I'll be closing this PR to avoid duplicates, let me know if I have to change anything else!