diff --git a/README.rst b/README.rst
index 1d9cb23..8bacc8e 100644
--- a/README.rst
+++ b/README.rst
@@ -2237,7 +2237,8 @@
             - node2.domain.com
             - service2.domain.com
 
-Set up ``resolvconf's basic resolver info``, e.g. nameservers, search/domain and options:
+Set up ``resolvconf's basic resolver info``, e.g. nameservers, search/domain and options.
+Parameter ``update_head`` will move changes to the top of resolv.conf if set to ``True``:
 
 .. code-block:: yaml
 
@@ -2248,6 +2249,7 @@
             - 8.8.4.4
             - 8.8.8.8
           domain: my.example.com
+          update_head: False
           search:
             - my.example.com
             - example.com