Suggest some mods

@samuel.gaist: please validate. I

• Suggested some text mods
• Suggested we move Usage to the top and Contents to later
• Suggested we need to add a couple of examples for potential users