fix documentation to make it more readable

This makes it easier to understand for new users.