Update doc on flow inheritance

Issue: SWF-1679
2016-07-07 17:05:04 -04:00
parent e3f220bbae
commit bbdc3765b5
1 changed files with 10 additions and 0 deletions
--- a/src/reference/flow-inheritance.xml
+++ b/src/reference/flow-inheritance.xml
@@ -65,6 +65,16 @@
 			<programlisting language="xml"><![CDATA[
 <view-state id="child-state" parent="parent-flow#parent-view-state">]]>
 			</programlisting>
+			<note>
+				<para>
+					The intent for flow-level inheritance is to define common states to be
+					added to and shared among multiple flow definitions while the intent
+					for state-level inheritance is to extend from and merge with a single
+					parent state. Flow-level inheritance is a good fit for composition
+					and multiple inheritance but at the state level you can still only
+					inherit from a single parent state.
+				</para>
+			</note>
 		</sect2>
 	</sect1>
 	<sect1 xml:id="flow-inheritance-abstract">