diff --git a/docs/hooks/hook_civicrm_alterEntityRefParams.md b/docs/hooks/hook_civicrm_alterEntityRefParams.md
index 6abf261db78656db3c1f106e23b3cfad1fc70fce..1361236b980116213cd9b77c239e2a8b0324521e 100644
--- a/docs/hooks/hook_civicrm_alterEntityRefParams.md
+++ b/docs/hooks/hook_civicrm_alterEntityRefParams.md
@@ -2,7 +2,7 @@
 
 ## Summary
 
-Allows you to modify entityRef field params.
+This hook is called when an `entityRef` field is rendered in a form, which allows you to modify the parameters used to fetch options for this kind of field.
 
 ## Availability
 
@@ -14,22 +14,17 @@ This hook is available in CiviCRM 4.7.27+ (maybe depends on the commit).
 
 ## Parameters
 
--   @param array $params - parameters of entityRef field
-
-## Details
-
- This hook is called when entityRef field is rendered in form, which allows you to modify the parameters used to fetch options for this kind of field.
-
+- array `$params` - parameters of entityRef field
 
 ## Example
 
 ```php
-     function myextension_civicrm_alterEntityRefParams(&$params) {
-       // use your custom API to fetch tags of your choice
-       if ($params['entity'] == 'tag') {
-         $params['entity'] = 'my_tags';
-         $params['api'] = array('params' => array('parent_id' => 292));
-       }
-       ...
-     }
+function myextension_civicrm_alterEntityRefParams(&$params) {
+  // use your custom API to fetch tags of your choice
+  if ($params['entity'] == 'tag') {
+    $params['entity'] = 'my_tags';
+    $params['api'] = array('params' => array('parent_id' => 292));
+  }
+  // ...
+}
 ```