diff --git a/docs/hooks/hook_civicrm_permission.md b/docs/hooks/hook_civicrm_permission.md
index 38e43f8a5a72769eaa19571a083ab70abc7d4e87..a62d97dae55a2616b18591dcf3b2b3b6c28ed160 100644
--- a/docs/hooks/hook_civicrm_permission.md
+++ b/docs/hooks/hook_civicrm_permission.md
@@ -9,6 +9,11 @@ This hook is called to allow custom permissions to be defined.
 Available starting in 4.3, with permission descriptions supported
 starting in 4.6.
 
+Before 4.7.21, extension permissions did not work properly in Joomla (see
+[CRM-12059](https://issues.civicrm.org/jira/browse/CRM-12059)). CiviCRM
+would recognize the permission but not give site administrators any way
+to grant it to users.
+
 ## Definition
 
     hook_civicrm_permission(&$permissions)
@@ -59,11 +64,6 @@ permissions, such as "create new item".
 Like in Drupal 6's hook_perm, there is no automatic namespacing for
 permissions, so one should adopt unique permission names.
 
-Extension permissions do not currently work properly in Joomla (see
-[CRM-12059](https://issues.civicrm.org/jira/browse/CRM-12059)).  CiviCRM
-will recognize the permission, but you will have no way to grant it to
-users.
-
 ## Example
 
 The following is an excerpt from [the CiviCRM Monitoring for