From bcfae26e6fde42ccb26938811fa10301270c6f87 Mon Sep 17 00:00:00 2001
From: Rossen Stoyanchev <rstoyanchev@pivotal.io>
Date: Fri, 17 Jun 2016 18:09:40 -0400
Subject: [PATCH] Update reference section on sub-flows

Issue: SWF-1648
---
 src/reference/defining-flows.xml | 7 ++++++-
 1 file changed, 6 insertions(+), 1 deletion(-)

diff --git a/src/reference/defining-flows.xml b/src/reference/defining-flows.xml
index 09978256..4f24523e 100644
--- a/src/reference/defining-flows.xml
+++ b/src/reference/defining-flows.xml
@@ -487,7 +487,12 @@ public interface FlowOutcome {
 			<sect3 xml:id="subflow-state-element-output">
 				<title>Mapping subflow output</title>
 				<para>
-					Simply refer to a subflow output attribute by its name within a outcome transition:
+					When a subflow completes, its end-state id is returned to the calling flow as
+					the event to use to continue navigation.
+				</para>
+				<para>
+					The subflow can also create output attributes to which the calling flow can refer
+					within an outcome transition as follows:
 				</para>
 				<programlisting language="xml"><![CDATA[
 <transition on="guestCreated" to="reviewBooking">