diff --git a/src/main/docbkx/developer.xml b/src/main/docbkx/developer.xml
index 71b82d74c7f..953977dd79c 100644
--- a/src/main/docbkx/developer.xml
+++ b/src/main/docbkx/developer.xml
@@ -254,7 +254,8 @@ mvn clean package -DskipTests
              The script <filename>dev-support/make_rc.sh</filename> automates most of this.</para>
 
         <para>The <link xlink:href="http://wiki.apache.org/hadoop/HowToRelease">Hadoop How To Release</link> wiki page informs much of the below and may have more detail on particular sections so it is worth review.</para>
-         <para>Update CHANGES.txt with the changes since the last release (query JIRA, export to excel then hack w/ vim to format to suit CHANGES.txt TODO: Needs detail).
+        <para>Update CHANGES.txt with the changes since the last release.
+            Make sure the URL to the JIRA points to the properly location listing fixes for this release.
              Adjust the version in all the poms appropriately; e.g. you may need to remove <emphasis>-SNAPSHOT</emphasis> from all versions.
              The <link xlink:href="http://mojo.codehaus.org/versions-maven-plugin/">Versions Maven Plugin</link> can be of use here.  To
              set a version in all poms, do something like this: