1 files changed, 92 insertions, 0 deletions
diff --git a/docs/clamp/acm/acm-states.rst b/docs/clamp/acm/acm-states.rst
index a36825a5..7a3222a5 100644
--- a/docs/clamp/acm/acm-states.rst
+++ b/docs/clamp/acm/acm-states.rst
@@ -80,4 +80,96 @@ Delete
 
 .. image:: images/acm-states/AcInstanceStatesDelete.png
 
+Automation Composition Instance Sub State
+=========================================
+The sub states that an Automation Composition Instance can have are shown in the diagram below.
+
+.. image:: images/acm-states/AcInstanceSubStates.png
+
+How State are saved in DB
+=========================
+Any state will be saved in DB as number:
+
+Participant Replica State
+-------------------------
+
++--------------------+------------+
+|  ParticipantState  |  Database  |
++====================+============+
+|  ON_LINE           |         0  |
++--------------------+------------+
+|  OFF_LINE          |         1  |
++--------------------+------------+
+
+
+Automation Composition Type State
+---------------------------------
+
++----------------+------------+
+|  AcTypeState   |  Database  |
++================+============+
+|  COMMISSIONED  |         0  |
++----------------+------------+
+|  PRIMING       |         1  |
++----------------+------------+
+|  PRIMED        |         2  |
++----------------+------------+
+|  DEPRIMING     |         3  |
++----------------+------------+
+
+Automation Composition Instance DeployState
+===========================================
+
++---------------+------------+
+|  DeployState  |  Database  |
++===============+============+
+|  DEPLOYED     |         0  |
++---------------+------------+
+|  DEPLOYING    |         1  |
++---------------+------------+
+|  UNDEPLOYED   |         2  |
++---------------+------------+
+|  UNDEPLOYING  |         3  |
++---------------+------------+
+|  DELETING     |         4  |
++---------------+------------+
+|  DELETED      |         5  |
++---------------+------------+
+|  UPDATING     |         6  |
++---------------+------------+
+|  MIGRATING    |         7  |
++---------------+------------+
+
+Automation Composition Instance Lock State
+==========================================
+
++-------------+------------+
+|  LockState  |  Database  |
++=============+============+
+|  LOCKED     |         0  |
++-------------+------------+
+|  LOCKING    |         1  |
++-------------+------------+
+|  UNLOCKED   |         2  |
++-------------+------------+
+|  UNLOCKING  |         3  |
++-------------+------------+
+|  NONE       |         4  |
++-------------+------------+
+
+Automation Composition Instance Sub State
+=========================================
+
++-------------------------+------------+
+|  SubState               |  Database  |
++=========================+============+
+|  NONE                   |         0  |
++-------------------------+------------+
+|  MIGRATION_PRECHECKING  |         1  |
++-------------------------+------------+
+|  PREPARING              |         2  |
++-------------------------+------------+
+|  REVIEWING              |         3  |
++-------------------------+------------+
+
 End of Document