ops/id-unification.md: updates following testing

1 files changed, 20 insertions, 12 deletions

diff --git a/ops/id-unification.md b/ops/id-unification.md
index 3f20f53..7132572 100644
--- a/ops/id-unification.md
+++ b/ops/id-unification.md
@@ -17,14 +17,8 @@ third-party instances.
 
 ## Upgrade process
 
-For meta.sr.ht:
-
-1. Disable automatic migrations
-1. Upgrade meta.sr.ht, restart the services, and ensure that the meta.sr.ht
-   GraphQL API is online
-1. Re-enable automatic migrations if desired
-
-Then, for each service, one at a time:
+Ensure meta.sr.ht is running version 0.60.4 or later. Then, for each service,
+one at a time:
 
 1. Disable automatic migrations
 1. Shut off the service
@@ -34,12 +28,26 @@ Then, for each service, one at a time:
 1. Turn on the service
 1. Re-enable automatic migrations if desired
 
-## Downgrade process
+**Note**: hub.sr.ht must be upgraded last, if present, and the other services
+must be running during its upgrade.
 
-1. Disable automatic migrations
-1. Downgrade meta.sr.ht and restart the services
+### pages.sr.ht
+
+A special upgrade process is required for pages.sr.ht, which does not use the
+same system for database migrations as other services. Perform the same steps as
+described above, then run the scripts in [contrib][contrib] in the following
+order:
+
+- ./contrib/add\_user\_remote\_id.py upgrade
+- ./contrib/use\_canonical\_user\_id.py upgrade
+
+To downgrade, repeat these commands in the reverse order with "downgrade".
+
+[contrib]: https://git.sr.ht/~sircmpwn/pages.sr.ht/tree/master/contrib
+
+## Downgrade process
 
-Then, for each service, one at a time:
+For each service (excluding meta.sr.ht), one at a time:
 
 1. Shut off the service
 1. Run `$service-migrate downgrade $version`, selecting $version from the list