totten
--- a/docs/upgrade/drupal8.md
+++ b/docs/upgrade/drupal8.md
+    ```
+    ```bash
+    cv flush
+    ```
+* Re-publish static assets (`*.js`, `*.css`, etc) with `composer`
+    ```bash
+    composer civicrm:publish
+    ```

-## Ensure that CiviCRM Assets are up to date.
-
-In some build processes it has been found that the static asses such as css files and js files are not synced between the vendor directory and the active libraries folder. To resolve this system admins should run `composer civicrm:publish` to republish assets such as the menu. See also [dev/core#4754](https://lab.civicrm.org/dev/core/-/issues/4754).
-
+The above steps should not normally be necessary, but they may help with customized workflows or
+with unresolved bugs. If you identify a scenario where these steps are necessary, please
+[report an issue](https://civicrm.org/bug-reporting). (For example, [dev/core#4754](https://lab.civicrm.org/dev/core/-/issues/4754) reports about a scenario with assset publication.)