Document nested stack properties

This adds descriptions to the nested stack properties.

Fixes bug #1224150

Change-Id: I04a74f17e8e7ffc2a2d2bd0de333b103ee831744

diff --git a/heat/engine/resources/stack.py b/heat/engine/resources/stack.py
index 15f5e26cca24fa9b26b51d76cddbdc766b6b816e..9505da6be21dfb7a572dc0ef6280eae8c3c3e9a8 100644 (file)
--- a/heat/engine/resources/stack.py
+++ b/heat/engine/resources/stack.py
@@ -34,10 +34,20 @@ class NestedStack(stack_resource.StackResource):
     A Resource representing a child stack to allow composition of templates.
     '''
 
-    properties_schema = {PROP_TEMPLATE_URL: {'Type': 'String',
-                                             'Required': True},
-                         PROP_TIMEOUT_MINS: {'Type': 'Number'},
-                         PROP_PARAMETERS: {'Type': 'Map'}}
+    properties_schema = {
+        PROP_TEMPLATE_URL: {
+            'Type': 'String',
+            'Required': True,
+            'Description': _('The URL of a template that specifies the stack'
+                             ' to be created as a resource.')},
+        PROP_TIMEOUT_MINS: {
+            'Type': 'Number',
+            'Description': _('The length of time, in minutes, to wait for the'
+                             ' nested stack creation.')},
+        PROP_PARAMETERS: {
+            'Type': 'Map',
+            'Description': _('The set of parameters passed to this nested'
+                             ' stack.')}}
 
     update_allowed_keys = ('Properties',)
     update_allowed_properties = (PROP_TEMPLATE_URL, PROP_TIMEOUT_MINS,