diff --git a/jobs.yaml b/jobs.yaml
index eb1cee0..ee26930 100644
--- a/jobs.yaml
+++ b/jobs.yaml
@@ -16,7 +16,8 @@
             predefined-parameters: dir=$WORKSPACE
 - job:
     name: mininet-precise32server-test
-    description: 'Test of Ubuntu 14.04 LTS 32-bit VM\n'
+    description: |
+        Test of Ubuntu 14.04 LTS 32-bit VM
     project-type: freestyle
     block-downstream: false
     builders:
@@ -25,7 +26,8 @@
 # Mininet - Precise 64-bit
 - job:
     name: mininet-precise64server
-    description: 'Ubuntu 12.04 LTS 64-bit VM build\n'
+    description: |
+        Ubuntu 12.04 LTS 64-bit VM build
     project-type: freestyle
     block-downstream: false
     triggers:
@@ -39,7 +41,8 @@
             predefined-parameters: dir=$WORKSPACE
 - job:
     name: mininet-precise64server-test
-    description: 'Test of Ubuntu 14.10 LTS 64-bit VM\n'
+    description: |
+       Test of Ubuntu 14.10 LTS 64-bit VM
     project-type: freestyle
     block-downstream: false
     builders:
@@ -47,7 +50,8 @@
 # Mininet - Trusty 32-bit
 - job:
     name: mininet-trusty32server
-    description: 'Ubuntu 14.04 LTS 32-bit VM build\n'
+    description: |
+       Ubuntu 14.04 LTS 32-bit VM build
     project-type: freestyle
     block-downstream: false
     triggers:
@@ -62,7 +66,8 @@
 
 - job:
     name: mininet-trusty32server-test
-    description: 'Test of Ubuntu 14.04 LTS 32-bit VM\n'
+    description: |
+        Test of Ubuntu 14.04 LTS 32-bit VM
     project-type: freestyle
     block-downstream: false
     builders:
@@ -70,7 +75,8 @@
 
 - job:
     name: mininet-trusty32server-test-full
-    description: 'Test of Ubuntu 14.04 LTS 32-bit VM\n'
+    description: |
+        Test of Ubuntu 14.04 LTS 32-bit VM
     project-type: freestyle
     block-downstream: false
     builders:
@@ -79,7 +85,8 @@
 # Mininet - Trusty 64-bit
 - job:
     name: mininet-trusty64server
-    description: 'Ubuntu 14.04 LTS 64-bit VM build\n'
+    description: |
+        Ubuntu 14.04 LTS 64-bit VM build
     project-type: freestyle
     block-downstream: false
     triggers:
@@ -93,7 +100,8 @@
             predefined-parameters: dir=$WORKSPACE
 - job:
     name: mininet-trusty64server-test
-    description: 'Test of Ubuntu 14.04 LTS 64-bit VM\n'
+    description: |
+        Test of Ubuntu 14.04 LTS 64-bit VM
     project-type: freestyle
     block-downstream: false
     builders:
@@ -102,7 +110,8 @@
 # Mininet - Utopic 32-bit
 - job:
     name: mininet-utopic32server
-    description: 'Ubuntu 14.10 LTS 32-bit VM build\n'
+    description: |
+        Ubuntu 14.10 LTS 32-bit VM build
     project-type: freestyle
     block-downstream: false
     triggers:
@@ -116,7 +125,8 @@
             predefined-parameters: dir=$WORKSPACE
 - job:
     name: mininet-utopic32server-test
-    description: 'Test of Ubuntu 14.04 LTS 32-bit VM\n'
+    description: |
+        Test of Ubuntu 14.04 LTS 32-bit VM
     project-type: freestyle
     block-downstream: false
     builders:
@@ -125,7 +135,8 @@
 # Mininet - Utopic 64-bit
 - job:
     name: mininet-utopic64server
-    description: 'Ubuntu 14.10 LTS 64-bit VM build\n'
+    description: |
+        Ubuntu 14.10 LTS 64-bit VM build
     project-type: freestyle
     block-downstream: false
     triggers:
@@ -139,7 +150,8 @@
             predefined-parameters: dir=$WORKSPACE
 - job:
     name: mininet-utopic64server-test
-    description: 'Test of Ubuntu 14.10 LTS 64-bit VM\n'
+    description: |
+        Test of Ubuntu 14.10 LTS 64-bit VM
     project-type: freestyle
     block-downstream: false
     builders:
@@ -148,7 +160,10 @@
 # ---- the following are jobs that update jenkins when this file is updated ----
 - job:
     name: update-jenkins-jobs
-    description: Auto-generated
+    description: |
+        This job updates Jenkins jobs automatically when updates are make to the YAML file.
+
+        To add or modify a job, look for the "vm-build" project on https://gerrit.onlab.us
     project-type: freestyle
     scm:
       - git:
@@ -174,7 +189,8 @@
 
 - job:
     name: update-jenkins-verify
-    description: TODO This will be used to verify new jobs using jenkins-job test before they are accepted in Gerrit.
+    description: |
+        This job is used to verify new Jenkins jobs using jenkins-job test before they are accepted in Gerrit.
     project-type: freestyle
     scm:
       - git: