diff --git a/README.rst b/README.rst
index 2e782e6..68390d7 100644
--- a/README.rst
+++ b/README.rst
@@ -378,6 +378,21 @@
             - node2.domain.com
             - service2.domain.com
 
+Setup resolv.conf, nameservers, domain and search domains
+
+.. code-block:: yaml
+
+    linux:
+      network:
+        resolv:
+          dns:
+            - 8.8.4.4
+            - 8.8.8.8
+          domain: my.example.com
+          search:
+            - my.example.com
+            - example.com
+
 Linux storage pillars
 ---------------------