Document 4.3 marking_store changes. Have reservations from a DX perspective, see https://github.com/symfony/symfony/pull/30551/files#r268391471

pbowyer · pbowyer · commit 6f511644a340 · 2019-03-23T11:39:09.000Z
diff --git a/workflow/usage.rst b/workflow/usage.rst
@@ -43,8 +43,9 @@ like this:
                     audit_trail:
                         enabled: true
                     marking_store:
-                        type: 'multiple_state' # or 'single_state'
+                        type: 'method'
                         arguments:
+                            - false
                             - 'currentPlace'
                     supports:
                         - App\Entity\BlogPost
@@ -80,7 +81,8 @@ like this:
                 <framework:workflow name="blog_publishing" type="workflow">
                     <framework:audit-trail enabled="true"/>
 
-                    <framework:marking-store type="single_state">
+                    <framework:marking-store type="method">
+                      <framework:argument>false</framework:argument>
                       <framework:argument>currentPlace</framework:argument>
                     </framework:marking-store>
 
@@ -127,8 +129,11 @@ like this:
                         'enabled' => true
                     ],
                     'marking_store' => [
-                        'type' => 'multiple_state', // or 'single_state'
-                        'arguments' => ['currentPlace'],
+                        'type' => 'method',
+                        'arguments' => [
+                            false,
+                            'currentPlace',
+                        ],
                     ],
                     'supports' => ['App\Entity\BlogPost'],
                     'places' => [
@@ -167,14 +172,14 @@ As configured, the following property is used by the marking store::
 
 .. note::
 
-    The marking store type could be "multiple_state" or "single_state".
-    A single state marking store does not support a model being on multiple places
-    at the same time.
+    The Workflow Component supports workflows that can be in one or multiple places
+    (states) at the same time. To restrict a workflow to a single state, set the first
+    argument to ``true`` when defining the ``marking_store``.
 
 .. tip::
 
-    The ``type`` (default value ``single_state``) and ``arguments`` (default
-    value ``marking``) attributes of the ``marking_store`` option are optional.
+    The ``type`` (default value ``method``) and ``arguments`` (default
+    values ``false`` and ``marking``) attributes of the ``marking_store`` option are optional.
     If omitted, their default values will be used.
 
 .. tip::
