Update README with structure, details

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