@@ -143,6 +143,10 @@ func outputsStr(os []*Output) string {
 				result += fmt.Sprintf("    %s: %s\n", kind, str)
 			}
 		}
+
+		if o.Description != "" {
+			result += fmt.Sprintf("  description\n    %s\n", o.Description)
+		}
 	}
 
 	return strings.TrimSpace(result)
 
@@ -499,6 +499,7 @@ func loadOutputsHcl(list *ast.ObjectList) ([]*Output, error) {
 
 		// Delete special keys
 		delete(config, "depends_on")
+		delete(config, "description")
 
 		rawConfig, err := NewRawConfig(config)
 		if err != nil {
@@ -520,10 +521,23 @@ func loadOutputsHcl(list *ast.ObjectList) ([]*Output, error) {
 			}
 		}
 
+		// If we have a description field, then filter that
+		var description string
+		if o := listVal.Filter("description"); len(o.Items) > 0 {
+			err := hcl.DecodeObject(&description, o.Items[0].Val)
+			if err != nil {
+				return nil, fmt.Errorf(
+					"Error reading description for output %q: %s",
+					n,
+					err)
+			}
+		}
+
 		result = append(result, &Output{
-			Name:      n,
-			RawConfig: rawConfig,
-			DependsOn: dependsOn,
+			Name:        n,
+			RawConfig:   rawConfig,
+			DependsOn:   dependsOn,
+			Description: description,
 		})
 	}
 
 
@@ -1058,6 +1058,11 @@ aws_instance.test (x1)
 `
 
 const basicOutputsStr = `
+web_id
+  vars
+    resource: aws_instance.web.id
+  description
+    The ID
 web_ip
   vars
     resource: aws_instance.web.private_ip
 
@@ -85,6 +85,11 @@ output "web_ip" {
     value = "${aws_instance.web.private_ip}"
 }
 
+output "web_id" {
+    description = "The ID"
+    value = "${aws_instance.web.id}"
+}
+
 atlas {
     name = "mitchellh/foo"
 }
@@ -88,6 +88,10 @@
     },
 
     "output": {
+        "web_id": {
+            "description": "The ID",
+            "value": "${aws_instance.web.id}"
+        },
         "web_ip": {
             "value": "${aws_instance.web.private_ip}"
         }
Original file line number	Diff line number	Diff line change
`@@ -143,6 +143,10 @@ func outputsStr(os []*Output) string {`
`143`	`143`	`result += fmt.Sprintf(" %s: %s\n", kind, str)`
`144`	`144`	`}`
`145`	`145`	`}`
	`146`	`+`
	`147`	`+ if o.Description != "" {`
	`148`	`+ result += fmt.Sprintf(" description\n %s\n", o.Description)`
	`149`	`+ }`
`146`	`150`	`}`
`147`	`151`
`148`	`152`	`return strings.TrimSpace(result)`
Original file line number	Diff line number	Diff line change
`@@ -85,6 +85,11 @@ output "web_ip" {`
`85`	`85`	`value = "${aws_instance.web.private_ip}"`
`86`	`86`	`}`
`87`	`87`
	`88`	`+output "web_id" {`
	`89`	`+ description = "The ID"`
	`90`	`+ value = "${aws_instance.web.id}"`
	`91`	`+}`
	`92`	`+`
`88`	`93`	`atlas {`
`89`	`94`	`name = "mitchellh/foo"`
`90`	`95`	`}`