diff --git a/docs/README.rst b/docs/README.rst
index 96ea61ae7..7e86882de 100644
--- a/docs/README.rst
+++ b/docs/README.rst
@@ -126,12 +126,17 @@ Undo the effects of ``salt.pkgrepo`` on Debian, RedHat, and SuSE.
 
 Clone selected `Salt formulas
 <http://docs.saltstack.com/en/latest/topics/development/conventions/formulas.html>`_
-Git repositories under ``/srv/formulas`` and makes them available in the
-relevant ``file_roots`` settings. Pillar data can be used to customize all
-paths, URLs, etc.
+Git repositories under ``/srv/formulas`` and makes them available in the relevant ``file_roots`` settings. Please note that in order for ``file_roots`` to be updated, ``salt.master`` must be called after ``salt.formulas``. For example:
 
-Here's a minimal pillar sample installing two formulas in the base
-environment.
+::
+
+    base:
+      'saltmain':
+        - salt.formulas
+        - salt.master
+    
+
+Pillar data can be used to customize all paths, URLs, etc. Here's a minimal pillar sample installing two formulas in the base environment:
 
 ::