clarify changelog prep

freedomofpress · Jan 11, 2021 · e82523a · e82523a
1 parent 8e69173
commit e82523a
Showing 1 changed file with 6 additions and 4 deletions.
diff --git a/docs/development/release_management.rst b/docs/development/release_management.rst
@@ -78,10 +78,12 @@ Pre-Release
 
 #. For each release candidate, update the version and changelog.
 
-   a. Collect a list of important changes from the `SecureDrop milestones
-      <https://github.com/freedomofpress/securedrop/milestones>`_ for the release, including
-      GitHub issues or PR numbers for each change. You will add these changes to the changelog in
-      the next step.
+   a. Collect a list of changes since the last release. For example, if the last release was version
+      1.6.0, you can view changes in Github by running:
+      `https://github.com/freedomofpress/securedrop/compare/release/1.6.0...develop`. Also check
+      `SecureDrop milestones <https://github.com/freedomofpress/securedrop/milestones>`_ to make
+      sure all milestone changes there are included. Include GitHub PR numbers for each change.
+      You will add these changes to the changelog in the next step.
 
    #. Run ``update_version.sh`` in the dev shell to update the version and changelog. The script
       will open both the main repository changelog (``changelog.md``) and the one used for Debian