service/lists.md

@@ -552,11 +552,19 @@ name, which led to [incorrect Archived-At headers](https://gitlab.torproject.org
 
 ## Upgrades
 
-It's unclear how automated Mailman 3 upgrades will be, but right now
-we're relying on Debian packages for this.
+Besides the package upgrade, some port-upgrade commands need to be run manually
+to handle the database schema upgrade and static files.
 
-The [Wikimedia foundation guide](https://wikitech.wikimedia.org/wiki/Mailman#Upgrading_Mailman3) has instructions that could be
-relevant here.
+The [Wikimedia foundation guide](https://wikitech.wikimedia.org/wiki/Mailman#Upgrading_Mailman3)
+has instructions that are informative, but not usable as-is in our environment.
+
+### Database schema
+
+### Static files
+
+After upgrading the package, run this command to refresh the static files:
+
+     sudo -u www-data /usr/share/mailman3-web/manage.py collectstatic --noinput --clear --verbosity 1
 
 ## SLA