From db1bfe9c192f88c0cd7d0fbd82691297f086f255 Mon Sep 17 00:00:00 2001
From: Deborah Barnard <deborah@starfallprojects.co.uk>
Date: Tue, 10 Oct 2023 12:31:11 +0100
Subject: [PATCH] workflow history draft

---
 _submodules/insiders                          |   2 +-
 .../_images/common-icons/workflow-history.png | Bin 0 -> 516 bytes
 .../executions/single-workflow-executions.md  |   7 +++++
 docs/workflows/history.md                     |  26 ++++++++++++++----
 mkdocs.yml                                    |   1 +
 5 files changed, 29 insertions(+), 7 deletions(-)
 create mode 100644 docs/_images/common-icons/workflow-history.png

diff --git a/_submodules/insiders b/_submodules/insiders
index d2acbc12e..dbdc15687 160000
--- a/_submodules/insiders
+++ b/_submodules/insiders
@@ -1 +1 @@
-Subproject commit d2acbc12e0fbfcd573844af4018dbd0eae5e194c
+Subproject commit dbdc1568746fa00853f6807713d0de9abeb1a79b
diff --git a/docs/_images/common-icons/workflow-history.png b/docs/_images/common-icons/workflow-history.png
new file mode 100644
index 0000000000000000000000000000000000000000..a8e7ec9a91dc1491d7e6a0f4e3695e5ff1bc1d93
GIT binary patch
literal 516
zcmV+f0{i`mP)<h;3K|Lk000e1NJLTq000sI000yS1^@s6fR}Ab00009a7bBm000ie
z000ie0hKEb8vp<R2XskIMF-~!3JVktC);f70004_Nkl<ZIE~Ge%S#(k6o<b%#8rh%
z>X?YuCQgzr3Mq*iV!J4W)+b2+i>?I!veHeFiltCW#W7)wwrJBlC~00p;$wWQ)0Nkl
zjHbmb{H-p(!};zxhkLGQwOTFuAf+FWzJgqrhjOLLqp?vLD3!`sjV8_JAp+2bH6D6Y
z^a;NsNL<e7-TMzHir`i9B}U3*{~+s_5b%%lW_j^;P`Of-fkb?gK;SW|+l>%l+h?TB
z47q#}fYp_^*FcUl3Ws!N64Q+MywvIzr9TzCUX7)N*CgVT0DSqn*&CG07g_uG2>^3v
zPo4p064S(@5i+|!C=`E7Uk>|O<SApLBUe2O;dBQ8Pr^ZVGT&)5ngsR0bx=5@6AtM&
zCbvs<y8$>lKDoU$Cv6$&F0Z}no}l^JB!2%mM#_}liERU*X+zR;b!B#FaPR@kOLNrf
zmh^t*3IO<qwX5p>cWJkbG)Btg#q&7vso2dG{mkZB-}p={8X**%z@w@tis*Wf?GVR`
z?9)@eZEnkiPW4=oPVFCLv8)E?7Z(h;T>rkbch&v-*!}{`KAPgh7oqF`0000<MNUMn
GLSTZu)9TUy

literal 0
HcmV?d00001

diff --git a/docs/workflows/executions/single-workflow-executions.md b/docs/workflows/executions/single-workflow-executions.md
index e7c54e8c2..dec972501 100644
--- a/docs/workflows/executions/single-workflow-executions.md
+++ b/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.
diff --git a/docs/workflows/history.md b/docs/workflows/history.md
index 4650d6580..929ef9a52 100644
--- a/docs/workflows/history.md
+++ b/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.
diff --git a/mkdocs.yml b/mkdocs.yml
index 42bef9ef4..820e934d9 100644
--- a/mkdocs.yml
+++ b/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