Merge ~racb/git-ubuntu:release-process-changes-2 into git-ubuntu:master

[Robie Basak]

Make Jenkins happy

[Server Team CI bot (server-team-bot)]

PASSED: Continuous integration, rev:159535224bdf3684719ac68fc1c240a5d9e60a32
https://jenkins.ubuntu.com/server/job/git-ubuntu-ci/514/
Executed test runs:
    SUCCESS: VM Setup
    SUCCESS: Build
    SUCCESS: Unit Tests
    IN_PROGRESS: Declarative: Post Actions

Click here to trigger a rebuild:
https://jenkins.ubuntu.com/server/job/git-ubuntu-ci/514//rebuild

review: Approve (continuous-integration)

[Bryce Harrington (bryce)]

Looks good, thanks for updating the docs.

review: Approve

diff --git a/doc/release-process.md b/doc/release-process.md
index 4ae7749..b907433 100644
--- a/doc/release-process.md
+++ b/doc/release-process.md
@@ -47,11 +47,10 @@ Set it in the git repo:
   $ git checkout -b ${VERSION}-release
   $ echo "VERSION = '${VERSION}'" > gitubuntu/version.py
   $ git commit gitubuntu/version.py  -m "version: bump to ${VERSION}"
-  $ git tag --annotate ${VERSION}
+  $ git tag --annotate -m "${VERSION} Release" ${VERSION}
 
 The annotated tag is necessary, because the snap build mechanisms
-determine the version to set in the snap based on it.  For the
-annotation message, just say "${VERSION} Release".
+determine the version to set in the snap based on it.
 
 
 2.  Draft release announcement
@@ -209,17 +208,26 @@ time (e.g. a week or so) copy the snap to STABLE.
 6. Installation to Production
 -----------------------------
 
-Upgrading the software in production is straightforward:
+Upgrading the software in production is straightforward. Preferably
+examine the process listing to ensure that you stop the service at a
+time when no imports are running; otherwise, see LP: #1859042 first.
 
+  $ sudo systemctl --user stop usd-importer
   $ ssh serverstack-gu
   $ sudo snap list
   $ sudo snap refresh git-ubuntu
   $ sudo snap info git-ubuntu
+  $ sudo systemctl --user start usd-importer
 
 In case of trouble of any sort, restore the previous version:
 
+  $ sudo systemctl --user stop usd-importer
   $ sudo snap revert git-ubuntu
   $ sudo snap info git-ubuntu
+  $ sudo systemctl --user start usd-importer
+
+If the importer service code itself (rather than the importer code) has
+not changed, there is no need to restart the service.
 
 If there have been any changes to the systemd scripts or configs, they
 may need to be manually re-installed.  See usd-importer-service.md for
@@ -231,7 +239,7 @@ directions.
 
 Email the (gpg signed) announcement to:
 
-  To: [e-mail].
+  To: [e-mail]
   Cc: [e-mail]
 
 Upload a copy of the announcement to https://launchpad.net/usd-importer/