We should just remove this sentence and the class {} examples altogether.

Could you also reindent the hiera sections and use <pre></pre> tags? That makes it easier for folks to cut and paste from the README. But this is what we get when using a white space dependent markup :\