DO NOT MERGE

.vale.ini

@@ -1,5 +1,5 @@
 StylesPath = "styles"
-MinAlertLevel = warning
+MinAlertLevel = error
 Vocab = default
 [*.md]
 BasedOnStyles = from-write-good, n8n-styles, from-microsoft, Vale

_doctools/filesize.sh

@@ -0,0 +1,28 @@
+#!/bin/bash
+# This is a simple script to work out the average file sizes in a directory. 
+# It is intended to keep track of the size of the built docs, so run on
+# the _site directory after an mkdocs build.
+# Check if a directory is provided, otherwise use the current directory
+dir=${1:-.}
+
+# Find all files recursively and calculate total size and count
+file_info=$(find "$dir" -type f -printf "%s\n" 2>/dev/null)
+
+total_size=0
+file_count=0
+
+# Sum up sizes and count files
+while read -r size; do
+    total_size=$((total_size + size))
+    ((file_count++))
+done <<< "$file_info"
+
+# Calculate and display average file size
+if [[ $file_count -eq 0 ]]; then
+    echo "No files found in the directory."
+else
+    avg_size=$((total_size / file_count))
+    echo "Total files: $file_count"
+    echo "Total size: $total_size bytes"
+    echo "Average file size: $avg_size bytes"
+fi

_snippets/integrations/builtin/core-nodes/code-node.md

@@ -1,20 +1,21 @@
 Use the Code node to write custom JavaScript or Python and run it as a step in your workflow.
 
 /// note | Coding in n8n
-This page gives usage information about the Code node. For more guidance on coding in n8n, refer to the [Code](/code/index.md) section. It includes:
+This page gives usage information about the Code node. For more guidance on coding in n8n, refer to the following resources:
 
 * Reference documentation on [Built-in methods and variables](/code/builtin/overview.md)
 * Guidance on [Handling dates](/code/cookbook/luxon.md) and [Querying JSON](/code/cookbook/jmespath.md)
-* A growing collection of examples in the [Cookbook](/code/cookbook/code-node/index.md)
+* A collection of examples for the [Code node](/code/cookbook/code-node/index.md)
 ///
 
 /// note | Examples and templates
-For usage examples and templates to help you get started, refer to n8n's [Code integrations](https://n8n.io/integrations/code/){:target=_blank .external-link} page.
+For usage examples and templates to help you get started, refer to n8n's [Code integrations](https://n8n.io/integrations/code/) page.
 ///
 
 /// note | Function and Function Item nodes
-The Code node replaces the Function and Function Item nodes from version 0.198.0. If you're using an older version of n8n, you can still view the [Function node documentation](https://github.com/n8n-io/n8n-docs/blob/67935ad2528e2e30d7984ea917e4af2910a096ec/docs/integrations/builtin/core-nodes/n8n-nodes-base.function.md){:target=_blank .external-link} and [Function Item node documentation](https://github.com/n8n-io/n8n-docs/blob/67935ad2528e2e30d7984ea917e4af2910a096ec/docs/integrations/builtin/core-nodes/n8n-nodes-base.functionItem.md){:target=_blank .external-link}.
+The Code node replaces the Function and Function Item nodes from version 0.198.0. If you're using an older version of n8n, you can still view the [Function node documentation](https://github.com/n8n-io/n8n-docs/blob/67935ad2528e2e30d7984ea917e4af2910a096ec/docs/integrations/builtin/core-nodes/n8n-nodes-base.function.md) and [Function Item node documentation](https://github.com/n8n-io/n8n-docs/blob/67935ad2528e2e30d7984ea917e4af2910a096ec/docs/integrations/builtin/core-nodes/n8n-nodes-base.functionItem.md).
 ///
+
 ## Usage
 
 How to use the Code node.
@@ -43,8 +44,8 @@ If you self-host n8n, you can import and use built-in and external npm modules i
 
 If you use n8n Cloud, you can't import external npm modules. n8n makes two modules available for you:
 
-* [crypto Node.js module](https://nodejs.org/docs/latest-v18.x/api/crypto.html){:target=_blank .external-link}
-* [moment npm package](https://www.npmjs.com/package/moment){:target=_blank .external-link}
+* [crypto Node.js module](https://nodejs.org/docs/latest-v18.x/api/crypto.html)
+* [moment npm package](https://www.npmjs.com/package/moment)
 
 ### Built-in methods and variables
 
@@ -58,7 +59,7 @@ The Code node editing environment supports time-saving and useful keyboard short
 
 ## Python
 
-n8n added Python support in version 1.0. It doesn't include a Python executable. Instead, n8n provides Python support using [Pyodide](https://pyodide.org/en/stable/){:target=_blank .external-link}, which is a port of CPython to WebAssembly. This limits the available Python packages to the [Packages included with Pyodide](https://pyodide.org/en/stable/usage/packages-in-pyodide.html#packages-in-pyodide){:target=_blank .external-link}. n8n downloads the package automatically the first time you use it.
+n8n added Python support in version 1.0. It doesn't include a Python executable. Instead, n8n provides Python support using [Pyodide](https://pyodide.org/en/stable/), which is a port of CPython to WebAssembly. This limits the available Python packages to the [Packages included with Pyodide](https://pyodide.org/en/stable/usage/packages-in-pyodide.html#packages-in-pyodide). n8n downloads the package automatically the first time you use it.
 
 /// note | Slower than JavaScript
 The Code node takes longer to process Python than JavaScript. This is due to the extra compilation steps.

_snippets/integrations/builtin/core-nodes/data-transformation-actions/data-section-link.md

@@ -1 +1 @@
-Learn more about [data structure and data flow](/data/index.md) in n8n workflows.
+Learn more about [data structure and data flow](/data/overview.md) in n8n workflows.

_snippets/integrations/builtin/core-nodes/schedule/timezone-settings.md

@@ -2,5 +2,5 @@
 The node relies on the timezone setting. n8n uses either:
 
 1. The workflow timezone, if set. Refer to [Workflow settings](/workflows/settings.md) for more information.
-2. The n8n instance timezone, if the workflow timezone isn't set. The default is `America/New York` for self-hosted instances. n8n Cloud tries to detect the instance owner's timezone when they sign up, falling back to GMT as the default. Self-hosted users can change the instance setting using [Environment variables](/hosting/configuration/environment-variables/timezone-localization.md). Cloud admins can change the instance timezone in the [Admin dashboard](/manage-cloud/set-cloud-timezone.md).
+2. The n8n instance timezone, if the workflow timezone isn't set. The default is `America/New York` for self-hosted instances. n8n Cloud tries to detect the instance owner's timezone when they sign up, falling back to GMT as the default. Self-hosted users can change the instance setting using [Environment variables](/hosting/configuration/environment-variables.md#timezone-and-localization). Cloud admins can change the instance timezone in the [Admin dashboard](/manage-cloud/set-cloud-timezone.md).
 ///

_snippets/privacy-security/gdpr-self-hosted.md

@@ -1 +1 @@
-If you self-host n8n, you are responsible for deleting user data. If you need to delete data on behalf of one of your users, you can delete the respective execution. n8n recommends configuring n8n to prune execution data automatically every few days to avoid effortful GDPR request handling as much as possible. Configure this using the `EXECUTIONS_DATA_MAX_AGE` environment variable. Refer to [Environment variables](/hosting/configuration/environment-variables/index.md) for more information.
+If you self-host n8n, you are responsible for deleting user data. If you need to delete data on behalf of one of your users, you can delete the respective execution. n8n recommends configuring n8n to prune execution data automatically every few days to avoid effortful GDPR request handling as much as possible. Configure this using the `EXECUTIONS_DATA_MAX_AGE` environment variable. Refer to [Environment variables](/hosting/configuration/environment-variables.md) for more information.

_snippets/self-hosting/installation/server-setups-next-steps.md

@@ -1,2 +1,2 @@
-* Learn more about [configuring](/hosting/configuration/environment-variables/index.md) and [scaling](/hosting/scaling/overview.md) n8n.
-* Or explore using n8n: try the [Quickstarts](/try-it-out/index.md).
+* Learn more about [configuring](/hosting/configuration/environment-variables.md) and [scaling](/hosting/scaling/overview.md) n8n.
+* Or explore using n8n: try the [Tutorials](/tutorials/index.md).

_snippets/workflows/dirty-nodes.md

@@ -0,0 +1,12 @@
+A 'dirty' node is simply one which has executed sucessfully in the past, but the resulting output is considered stale or unreliable.
+
+## How does a node get to be 'dirty'
+
+There are a number of ways that execution data can be flagged as stale:
+
+
+## How to recognise 'dirty' node data
+
+In the canvas of the workflow editor, dirty notes can be identified by a different-colored border and a yellow triangle where previously it had a green 'tick' symbol. For example:
+
+![image of node displayed with yellow border]()

docs/1-0-migration-checklist.md

@@ -15,7 +15,7 @@ The release of n8n 1.0 marks a milestone in n8n's journey to make n8n available
 
 ### Python support in the Code node
 
-Although JavaScript remains the default language, you can now also select Python as an option in the [Code node](/code/code-node.md) and even make use of [many Python modules](https://pyodide.org/en/stable/usage/packages-in-pyodide.html#packages-in-pyodide){:target=_blank .external link}. Note that Python is unavailable in Code nodes added to a workflow before v1.0.
+Although JavaScript remains the default language, you can now also select Python as an option in the [Code node](/integrations/builtin/core-nodes/n8n-nodes-base.code/index.md) and even make use of [many Python modules](https://pyodide.org/en/stable/usage/packages-in-pyodide.html#packages-in-pyodide){:target=_blank .external link}. Note that Python is unavailable in Code nodes added to a workflow before v1.0.
 
 [PR #4295](https://github.com/n8n-io/n8n/pull/4295){:target=_blank .external link}, [PR #6209](https://github.com/n8n-io/n8n/pull/6209){:target=_blank .external link}
 

docs/_extra/css/extra.css

@@ -466,3 +466,16 @@
 .bottom-link .footer-link {
 	color: #20b69e;
 }
+
+#__nav_1_label,
+#__nav_2_label,
+#__nav_3_label,
+#__nav_4_label,
+#__nav_5_label,
+.md-nav--primary > .md-nav__list > .md-nav__item--active > .md-nav__container {
+	color: rgb(144, 146, 152);
+	font-weight: 600;
+	font-size: 16px;
+	letter-spacing: 3px;
+	text-transform: uppercase;
+}

docs/_redirects

@@ -1,6 +1,39 @@
 ### THESE REDIRECTS ARE HANDLED BY NETLIFY, SEE DOC FOR DETAILS ###
 ### https://docs.netlify.com/routing/redirects/redirect-options/ ###
 
+## Redirects from docs reorg
+/learning-path/ /tutorials/
+/code/ /using-n8n/
+/code/code-node/ /integrations/builtin/core-nodes/n8n-nodes-base.code/
+/code/cookbook/builtin/ /code/builtin/overview/
+/code/cookbook/http-node/ /code/cookbook/http-node/pagination/
+/courses/ /tutorials/
+/data/code/ /integrations/builtin/core-nodes/n8n-nodes-base.code/
+/hosting/community-edition-features/ /choosing-n8n/#feature-comparison
+/hosting/community-edition-features/#registered-community-edition /choosing-n8n/#registered-community-edition-license
+/hosting/configuration/environment-variables/binary-data/ /hosting/configuration/environment-variables/#binary-data
+/hosting/configuration/environment-variables/credentials/ /hosting/configuration/environment-variables/#credentials
+/hosting/configuration/environment-variables/database/ /hosting/configuration/environment-variables/#databases
+/hosting/configuration/environment-variables/deployment/ /hosting/configuration/environment-variables/#deployment
+/hosting/configuration/environment-variables/endpoints/ /hosting/configuration/environment-variables/#endpoints
+/hosting/configuration/environment-variables/executions/ /hosting/configuration/environment-variables/#executions
+/hosting/configuration/environment-variables/external-data-storage/ /hosting/configuration/environment-variables/#external-data-storage
+/hosting/configuration/environment-variables/external-hooks/ /hosting/configuration/environment-variables/#external-hooks
+/hosting/configuration/environment-variables/external-secrets/ /hosting/configuration/environment-variables/#external-secrets
+/hosting/configuration/environment-variables/licenses/ /hosting/configuration/environment-variables/#licenses
+/hosting/configuration/environment-variables/logs/ /hosting/configuration/environment-variables/#logs
+/hosting/configuration/environment-variables/nodes/ /hosting/configuration/environment-variables/#nodes
+/hosting/configuration/environment-variables/queue-mode/ /hosting/configuration/environment-variables/#queue-mode
+/hosting/configuration/environment-variables/security/ /hosting/configuration/environment-variables/#security
+/hosting/configuration/environment-variables/source-control/ /hosting/configuration/environment-variables/#source-control
+/hosting/configuration/environment-variables/task-runners/ /hosting/configuration/environment-variables/#task-runners
+/hosting/configuration/environment-variables/timezone-localization/ /hosting/configuration/environment-variables/#timezone-and-localization
+/hosting/configuration/environment-variables/user-management-smtp-2fa/ /hosting/configuration/environment-variables/#user-management-smtp-and-two-factor-authentication
+/hosting/configuration/environment-variables/workflows/ /hosting/configuration/environment-variables/#workflows
+/integrations/builtin/trigger-nodes/ /integrations/builtin/app-nodes/
+/workflows/components/ /workflows/
+/hosting/installation/updating/ /hosting/
+
 ## Remove item lists (hidden for over a year)
 /integrations/builtin/core-nodes/n8n-nodes-base.itemlists/ /data/transforming-data/
 

docs/_workflows/try-it-out/quickstart/tutorial.json

@@ -190,4 +190,4 @@
       "name": "docs"
     }
   ]
-}
+}

docs/advanced-ai/index.md

@@ -53,7 +53,7 @@ Related documentation and tools.
 
 ### Node types
 
-This feature uses [Cluster nodes](/integrations/builtin/cluster-nodes/index.md): groups of [root](/integrations/builtin/cluster-nodes/root-nodes/index.md) and [sub](/integrations/builtin/cluster-nodes/sub-nodes/index.md) nodes that work together.
+This feature uses [Cluster nodes](/integrations/builtin/cluster-nodes/root-nodes/index.md): groups of [root](/integrations/builtin/cluster-nodes/root-nodes/index.md) and [sub](/integrations/builtin/cluster-nodes/sub-nodes/index.md) nodes that work together.
 
 --8<-- "_snippets/integrations/builtin/cluster-nodes/cluster-nodes-summary.md"
 

docs/advanced-ai/intro-tutorial.md

@@ -16,7 +16,7 @@ Many people find it easier to take in new information in video format. This tuto
 
 ### What you will need
 
-- **n8n**: For this tutorial we recommend using the [n8n cloud](/manage-cloud/overview.md) service - there is a free trial for new users! For a self hosted service, refer to the [installation pages](/hosting/installation/docker.md).
+- **n8n**: For this tutorial we recommend using the [n8n cloud](/manage-cloud/index.md) service - there is a free trial for new users! For a self hosted service, refer to the [installation pages](/hosting/installation/docker.md).
 - **Credentials for a chat model**: This tutorial uses OpenAI, but you can easily use DeepSeek, Google Gemini, Groq, Azure, and others (see the [sub-nodes documentation](/integrations/builtin/cluster-nodes/sub-nodes/index.md) for more).
 
 ### What you will learn
@@ -49,7 +49,7 @@ In n8n, the AI agent is represented as a node with some extra connections.
 | Scope               | Generates language         | Performs complex, real-world tasks |
 | Example             | LLM generating a paragraph | An agent scheduling an appointment |
 
-By incorporating the AI agent as a node, n8n can combine AI-driven steps with traditional programming for efficient, real-world workflows. For instance, simpler tasks, like validating an email address, do not require AI, whereas a complex tasks, like processing the _content_ of an email or dealing with multimodal inputs (e.g., images, audio), are excellent uses of an AI agent.
+By incorporating the AI agent as a node, n8n can combine AI-driven steps with traditional programming for efficient, real-world workflows. For instance, simpler tasks, like validating an email address, don't require AI, whereas a complex tasks, like processing the _content_ of an email or dealing with multimodal inputs (for example images, audio), are excellent uses of an AI agent.
 
 ## 1. Create a new workflow
 
@@ -97,7 +97,7 @@ AI agents require a chat model to be attached to process the incoming prompts.
 1. Selecting the **OpenAI Chat model** from the list will attach it to the **AI Agent** node and open the node editor. One of the parameters which can be changed is the 'Model'. Note that for the basic OpenAI accounts, only the 'gpt-4o-mini' model is allowed.
 
 ??? explanation "Which chat model?"
-    As mentioned earlier, the LLM is the component which generates the text according to a prompt it is given. LLMs have to be created and trained, usually an intensive process. Different LLMS may have different capabilities or specialties, depending on the data they were trained with.
+    As mentioned earlier, the LLM is the component which generates the text according to a prompt it's given. LLMs have to be created and trained, usually an intensive process. Different LLMS may have different capabilities or specialties, depending on the data they were trained with.
 
 ## 5. Add credentials (if needed)
 
@@ -128,7 +128,7 @@ Now that the node is connected to the **Chat Trigger** and a chat model, we can
 
 ??? explanation "Accessing the logs..."
     You can access the logs for the AI node even when you aren't using the chat interface. Open up the **AI Agent** node and click on the **Logs** tab in the right hand panel.
-	![screenshot showing the Logs tab in the AIAgent](/_images/advanced-ai/ai-intro-logs.png)
+	![screenshot showing the Logs tab in the AI Agent](/_images/advanced-ai/ai-intro-logs.png)
 
 ## 7. Changing the prompt
 
@@ -147,7 +147,7 @@ The chat model is now giving us useful output, but there is something wrong with
 
 1. Use the chat and tell the chat model your name, for example "Hi there, my name is Nick".
 
-1. Wait for the response, then type the message "What's my name?". The AI will not be able to tell you, however apologetic it may seem. The reason for this is we are not saving the context. The AI Agent has no [memory](/glossary.md#ai-memory).
+1. Wait for the response, then type the message "What's my name?". The AI won't be able to tell you, however apologetic it may seem. The reason for this is we aren't saving the context. The AI Agent has no [memory](/glossary.md#ai-memory).
    ![image showing a conversation illustrating the above](/_images/advanced-ai/ai-intro-memory.png)
 
 1. In order to remember what has happened in the conversation, the AI Agent needs to preserve context. We can do this by adding memory to the **AI Agent** node. On the canvas click on the <span class="inline-image">![Add node icon](/_images/try-it-out/add-node-small.png){.off-glb}</span> on the bottom of the **AI Agent** node labeled "Memory".
@@ -164,7 +164,7 @@ Before we leave the workflow editor, remember to save the workflow or all your c
 
 ## Congratulations!
 
-You have taken your first steps in building useful and effective workflows with AI. In this tutorial we have investigated the basic building blocks of an AI workflow, added an **AI Agent** and a chat model, and adjusted the prompt to get the kind of output we wanted. We also added memory so the chat could retain context between messages.
+You've taken your first steps in building useful and effective workflows with AI. In this tutorial we've investigated the basic building blocks of an AI workflow, added an **AI Agent** and a chat model, and adjusted the prompt to get the kind of output we wanted. We also added memory so the chat could retain context between messages.
 
 [[ workflowDemo("file:////advanced-ai/tutorials/chat_complete.json") ]]
 

docs/advanced-ai/langchain/langchain-n8n.md

@@ -9,7 +9,7 @@ description: How LangChain concepts map to n8n, and which n8n nodes to use.
 
 This page explains how LangChain concepts and features map to n8n nodes.
 
-This page includes lists of the LangChain-focused nodes in n8n. You can use any n8n node in a workflow where you interact with LangChain, to link LangChain to other services. The LangChain features uses n8n's [Cluster nodes](/integrations/builtin/cluster-nodes/index.md).
+This page includes lists of the LangChain-focused nodes in n8n. You can use any n8n node in a workflow where you interact with LangChain, to link LangChain to other services. The LangChain features uses n8n's [Cluster nodes](/integrations/builtin/cluster-nodes/root-nodes/index.md).
 
 
 /// note | n8n implements LangChain JS