diff --git a/source/_docs/scene.markdown b/source/_docs/scene.markdown
index c2ede2d14ca..5ecd08c9f1c 100644
--- a/source/_docs/scene.markdown
+++ b/source/_docs/scene.markdown
@@ -27,9 +27,19 @@ scene:
         state: "on"
 ```
 
+## How to configure your scene
+
+In the scene you define in your YAML files, please ensure you use
+all required parameters as listed below.
+
+```yaml
 {% configuration %}
-name:
-  description: Friendly name of scene.
+name: 
+  description: Friendly name of the scene.
+  required: true
+  type: string
+description:
+  description: Description of the scene.
   required: true
   type: string
 entities:
@@ -37,6 +47,7 @@ entities:
   required: true
   type: list
 {% endconfiguration %}
+```
 
 As you can see, there are two ways to define the states of each `entity_id`: