(Maint) Documentation fixes

This removes some examples that seemed to just be orphaned in the examples
directory, fixes up the hiera examples, and updates some of the Provider docs
to mark parts of the API properly as public