Update README with structure, details

This PR updates the README file with a standard structure, index, more examples, and type/provider notes.