diff --git a/roles/extra_packages/README.md b/roles/extra_packages/README.md
index ffa7d0b01fbadf231490c94caecde085275ef2fc..6f3ec92b12930c547c77b41424872f1d1d167507 100644
--- a/roles/extra_packages/README.md
+++ b/roles/extra_packages/README.md
@@ -1 +1,12 @@
 This role adds all the packages we think are useful but aren't clearly a dependency of some function.
+
+Before calling, you may want to  define the following lists:
+
+extra_packages  #list of yum packages. Or see code on how to it loads an  alternative file  if not defined
+exclude 	#list of packages to exclude
+useEpel 	# if defined, it will enable epel repo
+
+
+Usage:
+  roles:
+  - { role: extra_packages, useEpel: True, tags: [ other, extra_packages ] }