workflow history draft

docs/workflows/executions/single-workflow-executions.md

@@ -10,6 +10,13 @@ The **Executions** list in a workflow shows all executions for that workflow.
 !!! note "Deleted workflows"
 	When you delete a workflow, n8n deletes its execution history as well. This means you can't view executions for deleted workflows.
 
+!!! note "Execution history and workflow history"
+	Don't confuse the execution list with [Workflow history](/workflows/history/).
+
+	Executions are workflow runs. With the executions list, you can see previous runs of the current version of the workflow. You can copy previous executions into the editor to [Debug and re-run past executions](/workflows/executions/debug/) in your current workflow.
+
+	Workflow history is previous versions of the workflow: for example, a version with a different node, or different parameters set.
+
 ## View executions for a single workflow
 
 In the workflow, select the **Executions** tab in the top menu. You can preview all executions of that workflow.

docs/workflows/history.md

@@ -7,10 +7,18 @@ description: View and restore previous versions of your workflow.
 # Workflow history
 
 !!! info "Feature availability"
-	* Full workflow history available on Enterprise Cloud and Self-hosted.
-	* Last five workflow versions available for Cloud Pro users.
+	* Full workflow history is available on Enterprise Cloud and Enterprise Self-hosted.
+	* The last five workflow versions are available for Cloud Pro users.
 
-Use workflow history to view and restore previous versions of your workflows.
+Use workflow history to view and restore previous versions of your workflows. 
+
+## Understand workflow history
+
+n8n creates a new version when you:
+
+ * Save your workflow.
+ * Restore an old version. n8n saves the latest version before restoring.
+ * Pull from a Git repository using [Source control](/source-control-environments/). Note that n8n saves versions to the instance database, not to Git.
 
 !!! note "Workflow history and execution history"
 	Don't confuse workflow history with the [Workflow-level executions list](/workflows/executions/single-workflow-executions/).
@@ -19,14 +27,20 @@ Use workflow history to view and restore previous versions of your workflows.
 
 	Workflow history is previous versions of the workflow: for example, a version with a different node, or different parameters set.
 
-
-
 ## View workflow history
 
+To view a workflow's history:
+
+1. Open the workflow.
+1. Select **Workflow history** <span class="inline-image">![Workflow history icon](/_images/common-icons/workflow-history.png)</span>. n8n opens a menu showing the saved workflow versions, and a canvas with a preview of the selected version.
+
 ## Restore or copy previous versions
 
 You can restore a previous workflow version, or make a copy of it:
 
 1. On the version you want to restore or copy, select **Options** <span class="inline-image">![Options icon](/_images/common-icons/three-dot-options-menu.png)</span>.
 1. Choose what you want to do:
-	* **Restore this version**
+	* **Restore this version**: replace your current workflow with the selected version.
+	* **Clone to new workflow**: create a new workflow based on the selected version.
+	* **Open version in new tab**: open a second tab displaying the selected version. Use this to compare versions.
+	* **Download**: download the version as JSON.

mkdocs.yml

@@ -149,6 +149,7 @@ nav:
       - Templates: workflows/templates.md
       - Sharing: workflows/sharing.md
       - Settings: workflows/settings.md
+      - Workflow history: workflows/history.md
       - Workflow ID: workflows/workflow-id.md
     - Manage credentials:
       - credentials/index.md