+* Upgrading
+
+ The ordering of these steps is only necessary if you intend to
+ use some new features of this release.
+
+ 0. install (use your OS package manager, or "make install")
+
+ 1. restart public-inbox-watch instances if you have any
+
+ 2. Optional: remove Plack::Middleware::Deflater if you're using
+ a custom .psgi file for PublicInbox::WWW. This only saves
+ some memory and CPU cycles, and you may also skip this step
+ if you expect to roll back to 1.5.0 for any reason.
+
+ Steps 3a and 3b may happen in any order, 3b is optional
+ and is only required to use new WWW and IMAP features.
+
+ 3a. restart existing read-only daemons if you have them
+ (public-inbox-nntpd, public-inbox-httpd)
+
+ 3b. run "public-inbox-index -c --reindex --rethread --all"
+ to reindex all configured inboxes
+
+ 4. configure and start the new public-inbox-imapd. This
+ requires reindexing in 3b, but there's no obligation to
+ run an IMAP server, either.
+