make cleanup optional

2 files changed, 6 insertions, 1 deletions

diff --git a/doc/update/8.4-to-8.5.md b/doc/update/8.4-to-8.5.md
index c8083a45470..d323131ab7d 100644
--- a/doc/update/8.4-to-8.5.md
+++ b/doc/update/8.4-to-8.5.md
@@ -64,7 +64,7 @@ sudo -u git -H bundle install --without postgres development test --deployment
 # PostgreSQL installations (note: the line below states '--without mysql')
 sudo -u git -H bundle install --without mysql development test --deployment
 
-# Clean up old gems
+# Optional: clean up old gems
 sudo -u git -H bundle clean
 
 # Run database migrations
diff --git a/doc/update/patch_versions.md b/doc/update/patch_versions.md
index ce7ae0d285c..f446ed0a35b 100644
--- a/doc/update/patch_versions.md
+++ b/doc/update/patch_versions.md
@@ -62,8 +62,13 @@ sudo -u git -H bundle install --without development test mysql --deployment
 # MySQL
 sudo -u git -H bundle install --without development test postgres --deployment
 
+# Optional: clean up old gems
 sudo -u git -H bundle clean
+
+# Run database migrations
 sudo -u git -H bundle exec rake db:migrate RAILS_ENV=production
+
+# Clean up assets and cache
 sudo -u git -H bundle exec rake assets:clean assets:precompile cache:clear RAILS_ENV=production
 ```