diff --git a/README.md b/README.md
index 6fa0998..8f936d6 100644
--- a/README.md
+++ b/README.md
@@ -2,12 +2,32 @@
 
 Beaker Hiera DSL Extension Library! This allows to easily use Hiera data in acceptance tests.
 
+## Usage
+
+The `write_hiera_config_on` method is the most important one.
+It writes the `hiera.yaml` file to the specified host or hosts.
+The version is always set to 5, as well as a default `datadir`.
+The `hierarchy` is directly what the [documentation](https://www.puppet.com/docs/puppet/7/hiera_config_yaml_5.html) specifies.
+It is then important to also copy the data from a local directory to the same host or hosts.
+
 ```ruby
 hierarchy = [
-  'fqdn/%{fqdn}.yaml',
-  'os/%{os.family}/%{os.release.major}.yaml',
-  'os/%{os.family}.yaml',
-  'common.yaml',
+  {
+    name: "Per-node data",
+    path: 'fqdn/%{facts.networking.fqdn}.yaml',
+  },
+  {
+    name: 'OS family version data',
+    path: 'family/%{facts.os.family}/%{os.release.major}.yaml',
+  },
+  {
+    name: 'OS family data',
+    path: 'family/%{facts.os.family}.yaml',
+  },
+  {
+    name: 'Common data',
+    path: 'common.yaml',
+  },
 ]
 write_hiera_config_on(host, hierarchy)
 copy_hiera_data_to(host, 'spec/acceptance/hieradata')
diff --git a/lib/beaker-hiera/helpers.rb b/lib/beaker-hiera/helpers.rb
index e0414b0..f2ddaed 100644
--- a/lib/beaker-hiera/helpers.rb
+++ b/lib/beaker-hiera/helpers.rb
@@ -9,17 +9,16 @@ module Hiera
         # @param [Host, Array<Host>, String, Symbol] host
         #   One or more hosts to act upon, or a role (String or Symbol) that
         #   identifies one or more hosts.
-        # @param [Array] hierarchy
-        #   One or more hierarchy paths
+        # @param [Array[Hash]] hierarchy
+        #   One or more paths within the Hiera data directory
         def write_hiera_config_on(host, hierarchy)
           block_on host do |hst|
             hiera_config = {
-              backends: 'yaml',
-              yaml: {
+              version: 5,
+              defaults: {
                 datadir: hiera_datadir(hst),
               },
               hierarchy: hierarchy,
-              logger: 'console',
             }
             create_remote_file hst, hst.puppet['hiera_config'], hiera_config.to_yaml
           end
diff --git a/spec/beaker-hiera/helpers_spec.rb b/spec/beaker-hiera/helpers_spec.rb
index f568867..004644f 100644
--- a/spec/beaker-hiera/helpers_spec.rb
+++ b/spec/beaker-hiera/helpers_spec.rb
@@ -19,7 +19,9 @@ def logger
   end
 
   describe '#write_hiera_config_on' do
-    let(:hierarchy) { ['nodes/%{::fqdn}', 'common'] }
+    let(:hierarchy) do
+      [{ name: 'Node', path: 'nodes/%{facts.networking.fqdn}.yaml' }, { name: 'common', path: 'common.yaml' }]
+    end
 
     it 'on host' do
       expect(subject).to receive(:create_remote_file).with(host, '/usr/face', %r{datadir: "/usr/code/hieradata"})
@@ -28,7 +30,9 @@ def logger
   end
 
   describe '#write_hiera_config' do
-    let(:hierarchy) { ['nodes/%{::fqdn}', 'common'] }
+    let(:hierarchy) do
+      [{ name: 'Node', path: 'nodes/%{facts.networking.fqdn}.yaml' }, { name: 'common', path: 'common.yaml' }]
+    end
 
     it 'delegates to #write_hiera_config_on with the default host' do
       expect(subject).to receive(:default).and_return(host)