plan proposition for the user guide

What does the code in the MR do ?

It improves the actual user guide in the documentation.

Where should the reviewer start ?

user_guide.md See comments in italic.