Update docs

- Relates to #194

docs/src/reference/asciidoc/getting-started.adoc

@@ -42,6 +42,12 @@ framework.
 
 |spring-statemachine-test
 |Support module for state machine testing.
+
+|spring-statemachine-cluster
+|Support module for Spring Cloud Cluster.
+
+|spring-statemachine-uml
+|Support module for UI uml modeling.
 |===
 
 == Using Gradle

docs/src/reference/asciidoc/samples/simple-machine.uml

@@ -0,0 +1,16 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<uml:Model xmi:version="20131001" xmlns:xmi="http://www.omg.org/spec/XMI/20131001" xmlns:uml="http://www.eclipse.org/uml2/5.0.0/UML" xmi:id="_AMP3IP8fEeW45bORGB4c_A" name="RootElement">
+  <packagedElement xmi:type="uml:StateMachine" xmi:id="_AMRFQP8fEeW45bORGB4c_A" name="StateMachine">
+    <region xmi:type="uml:Region" xmi:id="_AMRsUP8fEeW45bORGB4c_A" name="Region1">
+      <transition xmi:type="uml:Transition" xmi:id="_chgcgP8fEeW45bORGB4c_A" source="_EZrg4P8fEeW45bORGB4c_A" target="_FAvg4P8fEeW45bORGB4c_A">
+        <trigger xmi:type="uml:Trigger" xmi:id="_hs5jUP8fEeW45bORGB4c_A" event="_NeH84P8fEeW45bORGB4c_A"/>
+      </transition>
+      <transition xmi:type="uml:Transition" xmi:id="_egLIoP8fEeW45bORGB4c_A" source="_Fg0IEP8fEeW45bORGB4c_A" target="_EZrg4P8fEeW45bORGB4c_A"/>
+      <subvertex xmi:type="uml:State" xmi:id="_EZrg4P8fEeW45bORGB4c_A" name="S1"/>
+      <subvertex xmi:type="uml:State" xmi:id="_FAvg4P8fEeW45bORGB4c_A" name="S2"/>
+      <subvertex xmi:type="uml:Pseudostate" xmi:id="_Fg0IEP8fEeW45bORGB4c_A"/>
+    </region>
+  </packagedElement>
+  <packagedElement xmi:type="uml:Signal" xmi:id="_L01D0P8fEeW45bORGB4c_A" name="E1"/>
+  <packagedElement xmi:type="uml:SignalEvent" xmi:id="_NeH84P8fEeW45bORGB4c_A" name="SignalEventE1" signal="_L01D0P8fEeW45bORGB4c_A"/>
+</uml:Model>

docs/src/reference/asciidoc/sm.adoc

@@ -346,6 +346,38 @@ include::samples/DocsConfigurationSampleTests.java[tags=snippetYC]
 
 More about config model, refer to section <<devdocs-configmodel>>.
 
+=== Configuring Model
+`StateMachineModelFactory` is a hook to configure statemachine model
+without using a manual configuration. Essentially it is a thirt party
+integration to integrate into a configuration model.
+`StateMachineModelFactory` can be hooked into a configuration model by
+using a `StateMachineModelConfigurer` as shown above.
+
+[source,java,indent=0]
+----
+include::samples/DocsConfigurationSampleTests8.java[tags=snippetA]
+----
+
+As a custom example `CustomStateMachineModelFactory` would simply
+define two states, _S1_ and _S2_ and an event _E1_ between those
+states.
+
+[source,java,indent=0]
+----
+include::samples/DocsConfigurationSampleTests8.java[tags=snippetB]
+----
+
+[NOTE]
+====
+Defining a custom model is usually not what end user is looking for,
+although it is possible, however it is a central concept of allowing
+external access to this configuration model.
+====
+
+Example of using this model factory integration can be found from
+<<sm-papyrus>>. More generic info about custom model integration can
+be found from <<devdocs>>.
+
 [[statemachine-config-thingstoremember]]
 === Things to Remember
 
@@ -1672,3 +1704,39 @@ event is sent to particular, random or all machines.
 All possible options for expected are documented in javadocs
 {sm-statemachinetestplanbuilder-statemachinetestplanstepbuilder}[_StateMachineTestPlanStepBuilder_].
 ====
+
+[[sm-papyrus]]
+== Eclipse Modeling Support
+Defining a state machine configuration with UI modeling is supported
+via Eclipse Papyrus framework.
+
+From eclipse wizard create a new _Papyrus Model_ with `UML` _Diagram
+Language_. In this example it's named as `simple-machine`. Then you've
+given an option to choose various diagram kind's and a `StateMachine
+Diagram` mush be chooce.
+
+We want to create a machine having two states, `S1` and `S2` where
+`S1` is initial state. Then event `E1` is created to do a transition
+from `S1` to `S2`. In papyrus a machine would then look like something
+shown below.
+
+image::images/simple-machine.png[width=500]
+
+Behind a scenes a raw uml file would look like.
+
+[source,xml,indent=0]
+----
+include::samples/simple-machine.uml[]
+----
+
+After uml file is in place in your project, it can be imported into
+configuration using `StateMachineModelConfigurer` where
+`StateMachineModelFactory` is associated with a model.
+`UmlStateMachineModelFactory` is a special factory which knows howto
+process eclipse's uml structure.
+
+[source,java,indent=0]
+----
+include::samples/DocsUmlSampleTests1.java[tags=snippetA]
+----
+

docs/src/reference/asciidoc/whatsnew.adoc

@@ -17,5 +17,6 @@ interoperability with web applications.
 * Configuration model classes are now a public API.
 * New features in timer based events.
 * Configuration model verifier.
-* New samples, <<statemachine-examples-security>>, <<statemachine-examples-eventservice>>
+* New samples, <<statemachine-examples-security>>, <<statemachine-examples-eventservice>>.
+* UI modeling support using Eclipse Papyrus, <<sm-papyrus>>.