Merge branch 'docs-content-model-reorg' into docs/cm-reorg-controls-DOCF-6394

# Conflicts:
#	Packages/com.unity.inputsystem/Documentation~/predefined-interactions.md

Author: duckets

Packages/com.unity.inputsystem/Documentation~/Interactions.md

@@ -3,26 +3,12 @@ uid: input-system-interactions
 ---
 # Interactions
 
-- [Operation](#operation)
-  - [Multiple Controls on an Action](#multiple-controls-on-an-action)
-  - [Multiple Interactions on a Binding](#multiple-interactions-on-a-binding)
-  - [Timeouts](#timeouts)
-- [Using Interactions](#using-interactions)
-  - [Interactions applied to Bindings](#interactions-applied-to-bindings)
-  - [Interactions applied to Actions](#interactions-applied-to-actions)
-- [Predefined Interactions](#predefined-interactions)
-  - [Default Interaction](#default-interaction)
-  - [Press](#press)
-  - [Hold](#hold)
-  - [Tap](#tap)
-  - [SlowTap](#slowtap)
-  - [MultiTap](#multitap)
-- [Writing custom Interactions](#writing-custom-interactions)
-
-An Interaction represents a specific input pattern. For example, a [hold](#hold) is an Interaction that requires a Control to be held for at least a minimum amount of time.
-
-Interactions drive responses on Actions. You can place them on individual Bindings or an Action as a whole, in which case they apply to every Binding on the Action. At runtime, when a particular interaction completes, this triggers the Action.
-
-![Interaction Properties](Images/InteractionProperties.png)
-
-
+Use Interactions to interpret specific input patterns from Controls that define Action behavior.
+
+|Topic|Description|
+|-----|-----------|
+|[Introduction to interactions](introduction-interactions.md)| Use Interactions on Bindings and Actions to read control input patterns and trigger Actions.|
+|[Apply interactions to Bindings](apply-interactions-bindings.md)| Apply Interactions to individual Bindings.|
+|[Apply Interactions to Actions](apply-interactions-actions.md)| Apply Interactions to Actions, and all the Bindings associated with that Action. |
+|[Predefined interactions](predefined-interactions.md)| Use the Input System's default and built-in Interactions on your Actions and Bindings.|
+|[Write custom interactions](write-custom-interactions.md)| Write your own custom Interactions for your Actions and Bindings.|

Packages/com.unity.inputsystem/Documentation~/TableOfContents.md

@@ -71,6 +71,13 @@
   * [Input Action Assets](ActionAssets.md)
   * [Input Bindings](ActionBindings.md)
   * [Interactions](Interactions.md)
+    * [Introduction to interactions](introduction-interactions.md)
+    * [Apply interactions to Bindings](apply-interactions-bindings.md)
+    * [Apply Interactions to Actions](apply-interactions-actions.md)
+    * [Predefined interactions](predefined-interactions.md)
+      * [Default Interactions](default-interactions.md)
+      * [Built-in Interactions](built-in-interactions.md)
+    * [Write custom interactions](write-custom-interactions.md)
   * [Devices](Devices.md)
   * [Controls](controls.md)
   * [Processors](Processors.md)

Packages/com.unity.inputsystem/Documentation~/add-duplicate-delete-binding.md

@@ -2,21 +2,31 @@
 
 Open the [Actions Editor window](actions-editor.md) to add, duplicate, or delete bindings.
 
-To add a new Binding:
+## Add a binding 
 
-1. Select the Add (+) icon on the action you want to add it to
+To add a new binding to an action:
+
+1. Select the Add (+) icon on the action.
 2. Select the appropriate [binding type](binding-types.md) from the menu that appears.
 
-To delete an existing Binding:
+Once you have added a binding, the next step is usually to configure its [control path](./control-paths.md).
+
+## Delete a binding
+
+To delete an existing binding from an action:
 
-1. Right-click the action
+1. Right-click the action.
 2. Select __Delete__ from the context menu.
 
-To duplicate an existing Binding:
+## Duplicate a binding
 
-1. Right-click the action
+To duplicate an existing binding on an action:
+
+1. Right-click the action.
 2. Select __Duplicate__ from the context menu.
 
+## Multiple bindings
+
 You can add multiple bindings to an action, which is generally useful for supporting multiple types of input device. For example, in the default set of actions, the "Move" action has a binding to the left gamepad stick and the WSAD keys, which means input through any of these bindings will perform the action.
 
 ![The default "move" action with its multiple bindings highlighted](./Images/ActionWithMultipleBindings.png)<br/>

Packages/com.unity.inputsystem/Documentation~/apply-interactions-actions.md

@@ -0,0 +1,24 @@
+# Apply Interactions to Actions
+
+Applying Interactions directly to an Action is equivalent to applying them to all Bindings for the Action. You can use this instead of manually adding the same Interaction(s) to multiple Bindings.
+
+To apply Interactions to individual Bindings, refer to [Apply Interactions to Bindings](apply-interactions-bindings.md).
+
+If you apply Interactions to both an Action and its Bindings, then the effect is the same as if the Action's Interactions are on the list of Interactions on each of the Bindings. This means that the Input System applies the Binding's Interactions first, and then the Action's Interactions.
+
+## Apply Interactions to Actions via the Editor
+
+To apply interactions via the Input Action Editor: 
+
+1. Select an Action to edit, so that the right pane of the window displays the properties for that Action. 
+1. Select the plus icon on the __Interactions__ foldout to open a list of all available Interactions types. 
+1. Select an Interaction type to add an Interaction instance of that type. The Interaction now appears in the __Interactions__ foldout. 
+1. If the Interaction has any parameters, you can now edit them at this stage.
+
+## Apply Interactions to Actions via code
+
+If you create your Actions in code, you can add Interactions like this:
+
+```CSharp
+var Action = new InputAction(Interactions: "tap(duration=0.8)");
+```

Packages/com.unity.inputsystem/Documentation~/apply-interactions-bindings.md

@@ -0,0 +1,28 @@
+# Apply Interactions to Bindings
+
+When you create Bindings for your [Actions](actions.md), you can choose to add Interactions to the Bindings via the Editor, or via code.
+
+To apply Interactions to all Bindings on an Action, refer to [Apply Interactions to Actions](apply-interactions-actions.md).
+
+## Apply Interactions to Bindings via the Editor
+
+If you're using [project-wide actions](ActionsEditor.md), or [Input Action Assets](ActionAssets.md), you can add any Interaction to your Bindings via the Input Action editor. 
+
+1. Once you have [created some Bindings](ActionsEditor.md#bindings), select the Binding you want to add Interactions to, so that the right pane of the window displays the properties for that Binding. 
+1. Select the plus icon on the __Interactions__ foldout to open a list of all available Interactions types. 
+1. Select an Interaction type to add an Interaction instance of that type. The Interaction now appears in the __Interactions__ foldout. 
+1. If the Interaction has any parameters, you can now edit them at this stage.
+
+![Binding Processors](Images/BindingProcessors.png)
+
+To remove an Interaction, select the minus (-) button next to it. To change the [order of Interactions](introduction-interactions.md#multiple-interactions-on-a-binding), select the up and down arrows.
+
+## Apply Interactions to Bindings via code
+
+To add Interactions to Bindings that you created in code, you can use the following code sample as a template:
+
+```CSharp
+var Action = new InputAction();
+action.AddBinding("<Gamepad>/leftStick")
+    .WithInteractions("tap(duration=0.8)");
+```