Cleanup user documentation format

This PR tries to cleanup the user documentation format, so it looks nice.

Feel free to suggest things.