diff --git a/docs/dev/releasing.md b/docs/dev/releasing.md
index 1110285..e3cef8e 100644
--- a/docs/dev/releasing.md
+++ b/docs/dev/releasing.md
@@ -20,7 +20,7 @@ For beta or rc release, set `release_status => 'testing'`, otherwise set it to
 
 In `resource-agents-paf.spec`:
   * update the tag in the `_tag` variable (first line)
-  * update the version in `Version:`
+  * update the version in `Version:`. for beta or rc release, use X.Y~betaZ or X.Y~rcZ
   * edit the changelog
     * date format: `LC_TIME=C date +"%a %b %d %Y"`
   * take care of the `Release` field if there is multiple version of the package
@@ -28,6 +28,8 @@ In `resource-agents-paf.spec`:
 
 In `debian/`, edit the `changelog` file
 
+Edit the `CHANGELOG.md` file.
+
 ## Commit the changes
 
 ```