diff --git a/ddi-plugin.zip b/ddi-plugin.zip
index 8bbffea275abb364f3b0c98eb6b47f5abcfc1337..22c026e748f30fbe25a71d88f4e6a5566b8d3097 100644
Binary files a/ddi-plugin.zip and b/ddi-plugin.zip differ
diff --git a/heappe-plugin.zip b/heappe-plugin.zip
index e701069d461f8cc43d8919dcd2f1ce60693ecb6f..fb8279791a468ec0d32e70d6651ccea099513f6c 100644
Binary files a/heappe-plugin.zip and b/heappe-plugin.zip differ
diff --git a/workflow_with_heappe_jobs.md b/workflow_with_heappe_jobs.md
index b3262db29cfee0f8a8c7610ab220494bf4415419..b7133284da6bd28ca279b8fa183a26f16bd2f3b0 100644
--- a/workflow_with_heappe_jobs.md
+++ b/workflow_with_heappe_jobs.md
@@ -48,7 +48,7 @@ topology_template:
         token: { get_input: token }
         JobSpecification:
           Name: WRFJob
-    ...
+          ...
   # Outputs: values of attributes exposed by components described above
   outputs:
     ddi_post_process_results:
@@ -203,3 +203,54 @@ thanks to these lines in the import section:
 imports:
   - heappe-types:1.0.3
 ```
+
+## Section topology_template
+
+This section describes input parameters, components and relationships, outputs,
+and workflows of the application
+
+### subsection inputs
+
+In this subsection you declare input parameters, specifying which one are required
+and which one are not required with a default value that the user can override if needed.
+
+Here is the description on an input parameter `token` marked as required,
+so the user will have to provide a value to this input parameter before being able to deploy the application:
+
+```bash
+topology_template:
+  # Input parameters provided by the user and referenced in node templates below
+  inputs:
+    token:
+      type: string
+      required: true
+      description: "Access token"
+```
+
+These input parameters can be referenced in the next section node_templates in
+propertied of node templates, using the TOSCA function `get_input` like below:
+
+```yaml
+    WRF_DAY_1:
+      type: org.heappe.nodes.Job
+      properties:
+        token: { get_input: token }
+```
+
+### subsection node_templates
+
+This subsection describes components and relationships between this component
+
+  # Description of components and relationships between these components
+  node_templates:
+    # Here a HEAppE job referencing in its properties the token input parameter
+    WRF_DAY_1:
+      type: org.heappe.nodes.Job
+      metadata:
+        task: computation
+      properties:
+        token: { get_input: token }
+        JobSpecification:
+          Name: WRFJob
+          ...
+