diff --git a/core/src/main/resources/hudson/model/Job/_api.jelly b/core/src/main/resources/hudson/model/Job/_api.jelly
index 614db3c4c14603e7ee26d63f3187d3f0893a56bd..6a6378cd84581ac5aa48b2894ea9da223dc71b4c 100644
--- a/core/src/main/resources/hudson/model/Job/_api.jelly
+++ b/core/src/main/resources/hudson/model/Job/_api.jelly
@@ -27,7 +27,9 @@ THE SOFTWARE.
   <p>
     To programmatically obtain <tt>config.xml</tt>, hit <a href="../config.xml">this URL</a>.
     You can also POST an updated <tt>config.xml</tt> to the same URL to programmatically
-    update the configuration of a job.
+    update the configuration of a job.  Similarly, <a href="../description">this URL</a>
+    can be used to get and set just the job description.  POST form data with a
+    "description" parameter to set the description.
   </p>
 
   <h2>Perform a build</h2>
@@ -47,4 +49,4 @@ THE SOFTWARE.
   <p>
     To programmatically delete this job, do HTTP POST to <a href="../doDelete">this URL</a>. 
   </p>
-</j:jelly>
\ No newline at end of file
+</j:jelly>