diff --git a/docs/source/defining_hub_policies.rst b/docs/source/defining_hub_policies.rst
index a0b67eed..d979b6d1 100644
--- a/docs/source/defining_hub_policies.rst
+++ b/docs/source/defining_hub_policies.rst
@@ -131,6 +131,11 @@ Available policies
 The system currently looks for the following policies
 
 * ``tag``: checked during tag/untag/move operations
+* ``build_rpm``: control whether builds are allowed, this is superceding older
+                 ``build_from_srpm`` to handle all task types. ``build_from_srpm``
+                 and ``build_from_repo_id`` are now deprecated and will be removed
+                 when py2 support will be dropped (rhel6 builders).
+                 Default policy allows everything.
 * ``build_from_srpm``: checked when a build from srpm (not an SCM reference) is
   requested.
 * ``build_from_scm``: checked when a build task from SCM is executing on builder
diff --git a/docs/source/image_build.rst b/docs/source/image_build.rst
index 23a814d7..4e128b71 100644
--- a/docs/source/image_build.rst
+++ b/docs/source/image_build.rst
@@ -61,6 +61,9 @@ URL would have the ``?`` and ``#`` right next to each other.
 If we passed ``--ksurl`` the string above, and gave
 ``--kickstart "server-ec2.ks"``, then Koji would do the following:
 
+* Consult hub SCM policy ``build_rpm``. Name of the policy could change in the
+  future as it has misleading name now. Policy could check if the given SCM is
+  allowed for this method, etc. In case it deny the build, it ends here.
 * Clone the repository locally
 * Call ``git reset --hard 68c40eb7``
 * Search in the "fedora22" subdirectory of the clone for a file called