update docs (#4065)

Co-authored-by: Kartik Balasubramanian <22399046+HumanistSerif@users.noreply.github.com>
Co-authored-by: cubic-dev-ai[bot] <191113872+cubic-dev-ai[bot]@users.noreply.github.com>

docs/workflows/publish.md

@@ -5,9 +5,13 @@ contentType: howto
 
 # Saving and publishing workflows
 
-You can iterate on, test, and save changes to workflows as many times as you need. Then when you're ready to put the workflow into production, publish your workflow.
+n8n automatically saves your workflow changes every 5 seconds while you're editing. When you're ready to put the workflow into production, publish your workflow. This approach prevents accidental production changes while enabling safe iteration and review.
 
-This approach prevents accidental production changes while enabling safe iteration and review.
+## How saving works
+
+Changes save automatically every 5 seconds while you edit. No manual save button is required, though you can still use Ctrl+S or Cmd+S if preferred. All edits remain in draft until you publish.
+
+## How publishing works
 
 Publishing makes your workflow live and locks it to a specific version. Production executions will use this published version, not your latest edits. When you publish, your workflow will enable the following:
 
@@ -19,28 +23,36 @@ Publishing makes your workflow live and locks it to a specific version. Producti
 
 ![Initial state when workflow is opened](/_images/publish/open-workflow.png)
 
-**Changed state: You make changes to the the workflow**
+**Changed state: Autosaved changes yet to be published**
 
-![Changes to the workflow](/_images/publish/post-change.png)
+![Changes awaiting publish](/_images/publish/post-change.png)
 
-**Saved state: Saved changes awaiting publish**
+**Published state: All changes published**
 
-![Saved changes awaiting publish](/_images/publish/post-save.png)
+![All changes published](/_images/publish/all-published.png)
+
+**Changed state: New changes yet to be published**
+
+![New changes awaiting publish](/_images/publish/new-unpublished.png)
+
+
+## How collaboration works
+
+Only one person can edit a workflow at a time. If someone else is currently editing:
+
+- You see the workflow in read-only mode
+- The edit lock releases when they stop editing or become inactive
+- You can then take over editing with the latest changes
 
 ## Checking publishing status
 
-On the **Workflows** page, each workflow displays an indicator showing whether it is **Published** or **Not Published**.
+On the **Workflows** page, each workflow displays an indicator showing whether it is **Published** or **Not Published**. You will also be able to see the same indicator on the canvas header.
 
 ## Publishing a workflow
 
-The **Publish** button in the header indicates that a publish action is pending for one of these reasons:
+The **Publish** button in the canvas header is enabled whenever there are unpublished changes.
 
-* When you open a workflow and make changes to it
-* When you have saved changes that aren't published
-
-This indicator is independent from the act of saving your changes, which you must still do manually. Each time you save changes to a workflow, n8n creates a new version of the workflow.
-
-You can save your changes as many times as you need to, but the saved version goes live in production only when you publish the workflow.
+Each time you make a change to a workflow, n8n autosaves those changes to a new version of the workflow. These saved versions go live in production only when you publish the workflow after the changes.
 
 1. Click the **Publish** button to open the publishing modal
 2. The version name defaults to a UUID. Customize the name if you'd like and add a description of the version.
@@ -61,4 +73,4 @@ View and manage version history by clicking the history icon in the header. In t
 Unpublish a workflow from either:
 
 - The workflow settings menu
-- The version history page (unpublish action on published versions)
+- The version history page (unpublish action on published versions)