diff --git a/docs/drupal8/index.md b/docs/drupal8/index.md
index a11444b35044f5de43ad203f905acb729afcd042..fc27c44144e87e20a67b5a2345eb1c8d6c829cce 100644
--- a/docs/drupal8/index.md
+++ b/docs/drupal8/index.md
@@ -64,7 +64,7 @@ If `composer` is properly installed, then these example commands will add CiviCR
 ```
 cd /var/www/d8.example.org
 composer config extra.enable-patching true
-composer require civicrm/civicrm-asset-plugin:'~1.0'
+composer require civicrm/civicrm-asset-plugin:'~1.1'
 composer require civicrm/civicrm-{core,packages,drupal-8}:'~5.29'
 ```
 
@@ -79,6 +79,10 @@ If you'd like more details to understand these commands or common errors, then p
     This is possible with the popular [cweagans/composer-patches](https://github.com/cweagans/composer-patches)
     plugin. However, you must [opt-in to enable it](https://github.com/cweagans/composer-patches#allowing-patches-to-be-applied-from-dependencies).
 
+??? info "More detail: Compilation tasks"
+
+    When you first install or upgrade to CiviCRM version 5.31 or later you will be asked about running composer compile tasks. We strongly recommend that you select all as the answer to this question to ensure CiviCRM is able to compile assets using composer correctly. You can also run the following command `composer config extra.compile-mode all` to set the necessary composer configuration variable to `all` before performing the upgrade or install.
+
 ??? info "More detail: Required packages"
 
     | Package | Description |
diff --git a/docs/drupal9/index.md b/docs/drupal9/index.md
index 5a4ee03f4c058b8395f480cc233ab14546efea3f..4845008d5bdfcc2b26749e52069e897d4ab4e7cc 100644
--- a/docs/drupal9/index.md
+++ b/docs/drupal9/index.md
@@ -72,7 +72,7 @@ If `composer` is properly installed, then these example commands will add CiviCR
 ```
 cd /var/www/d9.example.org
 composer config extra.enable-patching true
-composer require civicrm/civicrm-asset-plugin:'~1.0'
+composer require civicrm/civicrm-asset-plugin:'~1.1'
 composer require civicrm/civicrm-{core,packages,drupal-8}:'~5.29'
 ```
 
@@ -87,6 +87,10 @@ If you'd like more details to understand these commands or common errors, then p
     This is possible with the popular [cweagans/composer-patches](https://github.com/cweagans/composer-patches)
     plugin. However, you must [opt-in to enable it](https://github.com/cweagans/composer-patches#allowing-patches-to-be-applied-from-dependencies).
 
+??? info "More detail: Compilation tasks"
+
+    When you first install or upgrade to CiviCRM version 5.31 or later you will be asked about running composer compile tasks. We strongly recommend that you select all as the answer to this question to ensure CiviCRM is able to compile assets using composer correctly. You can also run the following command `composer config extra.compile-mode all` to set the necessary composer configuration variable to `all` before performing the upgrade or install.
+
 ??? info "More detail: Required packages"
 
     | Package | Description |