diff --git a/scripts/upgrade b/scripts/upgrade
index c152ce5..bbaf187 100755
--- a/scripts/upgrade
+++ b/scripts/upgrade
@@ -1,7 +1,7 @@
 #!/bin/bash
 
 #=================================================
-# GENERIC STARTING
+# GENERIC START
 #=================================================
 # IMPORT GENERIC HELPERS
 #=================================================
@@ -24,7 +24,7 @@ port=$(ynh_app_setting_get $app port)
 db_name=$(ynh_app_setting_get $app db_name)
 
 #=================================================
-# FIX OLD THINGS
+# ENSURE DOWNWARD COMPATIBILITY
 #=================================================
 
 if [ "$is_public" = "Yes" ]; then
@@ -44,7 +44,7 @@ fi
 # CHECK THE PATH
 #=================================================
 
-# Normalize the url path syntax
+# Normalize the URL path syntax
 path_url=$(ynh_normalize_url_path $path_url)
 
 #=================================================
@@ -92,7 +92,7 @@ ynh_store_file_checksum "$final_path/CONFIG_FILE"
 # SETUP LOGROTATE
 #=================================================
 
-# Use logrotate to manage the logfile
+# Use logrotate to manage app-specific logfile(s)
 ynh_use_logrotate
 
 #=================================================
@@ -103,12 +103,12 @@ ynh_use_logrotate
 ynh_systemd_config
 
 #=================================================
-# GENERIC FINALISATION
+# GENERIC FINALIZATION
 #=================================================
-# SECURING FILES AND DIRECTORIES
+# SECURE FILES AND DIRECTORIES
 #=================================================
 
-# Set right permissions for curl install
+# Set right permissions for curl installation
 sudo chown -R root: $final_path
 
 #=================================================
@@ -122,7 +122,7 @@ fi
 # Make app public if necessary
 if [ $is_public -eq 1 ]
 then
-	# unprotected_uris allows SSO credentials to be passed anyway.
+	# unprotected_uris allows SSO credentials to be passed anyway
 	ynh_app_setting_set $app unprotected_uris "/"
 fi