Update README with structure, details
Update README with structure, details

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

Pmovil/puppet-remote_file,lwf/puppet-remote_file