Update README.md

Making it easier for others to navigate the documentation.
`examples` typo... and for sure they need improvements, but what do you exactly suggest with "improved and cleaned up"? what changes do you want to see?