Repository: n8n-io/n8n-docs
Pull request #2964: Doc 1319 update tutorial
Author: login: evilnick
Created: 2025-03-14T01:49:42Z | Merged: 2025-03-14T18:04:50Z

- Updates the 'longer' tutorial
- Adds example workflow
- updates the tutorial index


Diff:
diff --git a/docs/_images/try-it-out/tutorial-date.png b/docs/_images/try-it-out/tutorial-date.png
new file mode 100644
index 00000000000..2db0f203325
Binary files /dev/null and b/docs/_images/try-it-out/tutorial-date.png differ
diff --git a/docs/_images/try-it-out/tutorial-expression.png b/docs/_images/try-it-out/tutorial-expression.png
new file mode 100644
index 00000000000..9e0ced87946
Binary files /dev/null and b/docs/_images/try-it-out/tutorial-expression.png differ
diff --git a/docs/_workflows/try-it-out/quickstart/tutorial.json b/docs/_workflows/try-it-out/quickstart/tutorial.json
new file mode 100644
index 00000000000..9e6e561de07
--- /dev/null
+++ b/docs/_workflows/try-it-out/quickstart/tutorial.json
@@ -0,0 +1,176 @@
+{
+    "name": "Tutorial Workflow",
+    "nodes": [
+      {
+        "parameters": {
+          "rule": {
+            "interval": [
+              {
+                "field": "weeks",
+                "triggerAtDay": [
+                  1
+                ],
+                "triggerAtHour": 9
+              }
+            ]
+          }
+        },
+        "type": "n8n-nodes-base.scheduleTrigger",
+        "typeVersion": 1.2,
+        "position": [
+          0,
+          0
+        ],
+        "id": "03a18f7d-33a6-4532-858a-18815e0b9521",
+        "name": "Schedule Trigger"
+      },
+      {
+        "parameters": {
+          "resource": "donkiSolarFlare",
+          "additionalFields": {
+            "startDate": "={{$today.minus({days: 7}).toFormat('yyyy-MM-dd')}}"
+          }
+        },
+        "type": "n8n-nodes-base.nasa",
+        "typeVersion": 1,
+        "position": [
+          220,
+          0
+        ],
+        "id": "f228846f-c269-400d-babd-ebf499ccd5c1",
+        "name": "NASA",
+        "credentials": {
+          "nasaApi": {
+            "id": "OrHOWMTeLsZNIdF4",
+            "name": "NASA account"
+          }
+        }
+      },
+      {
+        "parameters": {
+          "conditions": {
+            "options": {
+              "caseSensitive": true,
+              "leftValue": "",
+              "typeValidation": "strict",
+              "version": 2
+            },
+            "conditions": [
+              {
+                "id": "2f469c8e-12b3-4ee5-95fc-ff81508d0b43",
+                "leftValue": "={{ $json.classType }}",
+                "rightValue": "C",
+                "operator": {
+                  "type": "string",
+                  "operation": "contains"
+                }
+              }
+            ],
+            "combinator": "and"
+          },
+          "options": {}
+        },
+        "type": "n8n-nodes-base.if",
+        "typeVersion": 2.2,
+        "position": [
+          440,
+          0
+        ],
+        "id": "ba44a3d6-c765-446d-9ad6-58b389c7bc38",
+        "name": "If"
+      },
+      {
+        "parameters": {
+          "resource": "request",
+          "operation": "send",
+          "binId": "1741914338605-0907339996192",
+          "binContent": "=There was a solar flare of class {{$json[\"classType\"]}}",
+          "requestOptions": {}
+        },
+        "type": "n8n-nodes-base.postBin",
+        "typeVersion": 1,
+        "position": [
+          680,
+          -60
+        ],
+        "id": "f677789a-cb79-48f5-a485-9114e2559b84",
+        "name": "PostBin(true)"
+      },
+      {
+        "parameters": {
+          "resource": "request",
+          "operation": "send",
+          "binId": "1741914338605-0907339996192",
+          "binContent": "=There was a solar flare of class {{$json[\"classType\"]}}",
+          "requestOptions": {}
+        },
+        "type": "n8n-nodes-base.postBin",
+        "typeVersion": 1,
+        "position": [
+          680,
+          120
+        ],
+        "id": "53d095c0-2893-4a38-a80d-60c23558ca07",
+        "name": "PostBin(false)"
+      }
+    ],
+    "pinData": {},
+    "connections": {
+      "Schedule Trigger": {
+        "main": [
+          [
+            {
+              "node": "NASA",
+              "type": "main",
+              "index": 0
+            }
+          ]
+        ]
+      },
+      "NASA": {
+        "main": [
+          [
+            {
+              "node": "If",
+              "type": "main",
+              "index": 0
+            }
+          ]
+        ]
+      },
+      "If": {
+        "main": [
+          [
+            {
+              "node": "PostBin(true)",
+              "type": "main",
+              "index": 0
+            }
+          ],
+          [
+            {
+              "node": "PostBin(false)",
+              "type": "main",
+              "index": 0
+            }
+          ]
+        ]
+      },
+      "PostBin(true)": {
+        "main": [
+          []
+        ]
+      }
+    },
+    "active": false,
+    "settings": {
+      "executionOrder": "v1"
+    },
+    "versionId": "5e59b35c-ff2f-4006-a09e-a0003c179b73",
+    "meta": {
+      "templateCredsSetupCompleted": true,
+      "instanceId": "1060f46e51fc7902c377ab29d7cbfb87696ddf6b3c5c27cbbb65c3cb36e21baf"
+    },
+    "id": "kubnlHf5by3BHpRl",
+    "tags": []
+  }
\ No newline at end of file
diff --git a/docs/try-it-out/index.md b/docs/try-it-out/index.md
index ad7a2484a52..2b611b74e1a 100644
--- a/docs/try-it-out/index.md
+++ b/docs/try-it-out/index.md
@@ -6,8 +6,8 @@ contentType: overview
 
 # Try it out
 
-This section gets you up and running with building workflows in n8n.
+The best way to learn n8n is by using our tutorials to get familiar with the user interface and the many different types of nodes and integrations available. Here is a selection of material to get you started:
 
-* Want a fast taster of n8n? Try the [Very quick quickstart](/try-it-out/quickstart.md).
-* Looking for a more detailed introduction? Check out the [Slightly longer introduction](/try-it-out/longer-introduction.md).
-* Prefer to work through extensive examples? Maybe the [courses](/courses/index.md) are for you.
+- Looking for a quick introduction? Check out the ["First Workflow" tutorial](/try-it-out/longer-introduction.md).
+- Interested in what you could do with AI? Find out [how to build an AI chat agent with n8n](/advanced-ai/intro-tutorial.md).
+- Prefer to work through extensive examples? Maybe the [courses](/courses/index.md) are for you.
diff --git a/docs/try-it-out/longer-introduction.md b/docs/try-it-out/longer-introduction.md
index f352bb0932d..3cf0792cbae 100644
--- a/docs/try-it-out/longer-introduction.md
+++ b/docs/try-it-out/longer-introduction.md
@@ -4,36 +4,36 @@ description: Quickstart covering key concepts in n8n.
 contentType: tutorial
 ---
 
-# A slightly longer introduction
+# Your first workflow
 
-This guide shows you how to automate a task using a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
+This guide will show you how to construct a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
 
-* Create a workflow from scratch. You'll build a workflow that runs every week to get data from NASA, filters the data, and generates two reports.
+* Create a workflow from scratch. 
 * Understand key concepts and skills, including:
     * Starting workflows with trigger nodes
     * Configuring [credentials](/glossary.md#credential-n8n)
-    * Manipulating data
+    * Processing data
     * Representing logic in an n8n workflow
     * Using [expressions](/glossary.md#expression-n8n)
 
+This quickstart uses [n8n Cloud](/manage-cloud/overview.md), which is recommended for new users. A free trial is available - if you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
 
-## Step one: Sign up for n8n
+## Step one: Create a new workflow
 
-This quickstart uses [n8n Cloud](/manage-cloud/overview.md). A free trial is available for new users. If you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
+When you open n8n, you'll see either:
 
-## Step two: New workflow
+* A window with a welcome message and two large buttons: Choose "Start from Scratch" to create a new workflow.
+* The **Workflows** list on the **Overview** page. Select the <span class="inline-image">![universal create resource icon](/_images/common-icons/universal-resource-button.png){.off-glb}</span> **button** to create a new workflow.
 
---8<-- "_snippets/try-it-out/new-workflow.md"
 
-
-## Step three: Add a trigger node
+## Step two: Add a trigger node
 
 n8n provides two ways to start a workflow:
 
-* Manually, by selecting **Test Workflow**, or from the CLI if you installed n8n with npm or Docker.
+* Manually, by selecting **Test Workflow**.
 * Automatically, using a trigger node as the first node. The trigger node runs the workflow in response to an external event, or based on your settings.
 
-For this tutorial, use the [Schedule trigger](/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger/index.md). This allows you to run the workflow on a schedule:
+For this tutorial, we'll use the [Schedule trigger](/integrations/builtin/core-nodes/n8n-nodes-base.scheduletrigger/index.md). This allows you to run the workflow on a schedule:
 
 1. Select **Add first step**.
 2. Search for **Schedule**. n8n shows a list of nodes that match the search.
@@ -44,42 +44,43 @@ For this tutorial, use the [Schedule trigger](/integrations/builtin/core-nodes/n
 7. Close the node details view to return to the canvas.
 
 
-## Step four: Add the NASA node and set up credentials
+## Step three: Add the NASA node and set up credentials
 
-The [NASA node](/integrations/builtin/app-nodes/n8n-nodes-base.nasa.md) allows you to interact with NASA's [public APIs](https://api.nasa.gov/){:target=_blank .external-link}. The API gives you data to work with in this tutorial.
+The [NASA node](/integrations/builtin/app-nodes/n8n-nodes-base.nasa.md) interacts with NASA's [public APIs](https://api.nasa.gov/){:target=_blank .external-link} to fetch useful data. We will use the real-time data from the API to find solar events.
 
 1. Select the **Add node** <span class="inline-image">![Add node icon](/_images/try-it-out/add-node-small.png){.off-glb}</span> connector on the Schedule Trigger node.
-2. Search for **NASA**. n8n shows a list of nodes that match the search.
-3. Select **NASA** to view a list of operations.
-4. Search for and select **Get a DONKI solar flare**. This operation returns a report about recent solar flares. When you select the operation, n8n adds the node to the canvas and opens it.
-5. To access the NASA APIs, you need to set up credentials:
+1. Search for **NASA**. n8n shows a list of nodes that match the search.
+1. Select **NASA** to view a list of operations.
+1. Search for and select **Get a DONKI solar flare**. This operation returns a report about recent solar flares. When you select the operation, n8n adds the node to the canvas and opens it.
+1. To access the NASA APIs, you need to set up credentials:
     1. Select the  **Credential for NASA API** dropdown.
-    2. Select **- Create New -**. n8n opens the credentials view.
-    3. Go to [NASA APIs](https://api.nasa.gov/){:target=_blank .external-link} and fill out the form in **Generate API Key**. NASA generates the key and displays it.
-    4. Copy the key, and paste it into **API Key** in n8n.
-    5. Select **Save**.
-    6. Close the credentials screen. n8n returns to the node. The new credentials should be automatically selected in **Credential for NASA API**.
-6. By default, DONKI Solar Flare provides data for the past 30 days. To limit it to just the last week, use **Additional Fields**:
+    1. Select **- Create New -**. n8n opens the credentials view.
+    1. Go to [NASA APIs](https://api.nasa.gov/){:target=_blank .external-link} and fill out the form from the **Generate API Key** link. The NASA site generates the key and emails it to the address you entered.
+    1. Check your email account for the API key. Copy the key, and paste it into **API Key** in n8n.
+    1. Select **Save**.
+    1. Close the credentials screen. n8n returns to the node. The new credentials should be automatically selected in **Credential for NASA API**.
+1. By default, DONKI Solar Flare provides data for the past 30 days. To limit it to just the last week, use **Additional Fields**:
     1. Select **Add field**.
-    2. Select **Start date**.
-    3. To get a report starting from a week ago, you can use an expression: next to **Start date**, select the **Expression** tab, then select the expand button <span class="inline-image">![Add node icon](/_images/common-icons/open-expression-editor.png){.off-glb}</span> to open the full expressions editor.
-    4. In the **Expression** field, enter the following expression:
+    1. Select **Start date**.
+    1. To get a report starting from a week ago, you can use an expression: next to **Start date**, select the **Expression** tab, then select the expand button <span class="inline-image">![Add node icon](/_images/common-icons/open-expression-editor.png){.off-glb}</span> to open the full expressions editor.
+    1. In the **Expression** field, enter the following expression:
     ```js
     {{$today.minus({days: 7}).toFormat('yyyy-MM-dd')}}
     ```
     This generates a date in the correct format, seven days before the current date.
 
-    /// note | Date and time in n8n
-    n8n uses Luxon to work with date and time, and also provides two variables for convenience: `$now` and `$today`. For more information, refer to [Expressions > Luxon](/code/cookbook/luxon.md). 
-    ///
+    ![image showing the expression above generating a date](/_images/try-it-out/tutorial-date.png)
 
-7. Close the **Edit Expression** modal to return to the NASA node.
-8. You can now check that the node is working and returning the expected date: select **Test step** to run the node manually. n8n calls the NASA API and displays details of solar flares in the past seven days in the **OUTPUT** section.
-9. Close the NASA node to return to the workflow canvas.
+    ??? explanation "Date and time formats in n8n..."
+        n8n uses Luxon to work with date and time, and also provides two variables for convenience: `$now` and `$today`. For more information, refer to [Expressions > Luxon](/code/cookbook/luxon.md).
 
-## Step five: Add logic with the If node
+1. Close the **Edit Expression** modal to return to the NASA node.
+1. You can now check that the node is working and returning the expected date: select **Test step** to run the node manually. n8n calls the NASA API and displays details of solar flares in the past seven days in the **OUTPUT** section.
+1. Close the NASA node to return to the workflow canvas.
 
-n8n supports complex logic in workflows. In this tutorial, use the [If node](/integrations/builtin/core-nodes/n8n-nodes-base.if.md) to create two branches that each generate a report from the NASA data. Solar flares have five possible classifications. You'll create logic that sends a report with the lower classifications to one output, and the higher classifications to another. 
+## Step four: Add logic with the If node
+
+n8n supports complex logic in workflows. In this tutorial we will use the [If node](/integrations/builtin/core-nodes/n8n-nodes-base.if.md) to create two branches that each generate a report from the NASA data. Solar flares have five possible classifications; we will add logic that sends a report with the lower classifications to one output, and the higher classifications to another.
 
 Add the If node:
 
@@ -93,19 +94,19 @@ Add the If node:
 		If you didn't follow the step in the previous section to run the NASA node, you won't see any data to work with in this step.
 		///
 
-    2. Change the comparison operation to **String > Contains**.
-    3. In **Value 2**, enter **X**. This is the highest classification of solar flare. In the next step, you will create two reports: one for X class solar flares, and one for all the smaller solar flares.
+    1. Change the comparison operation to **String > Contains**.
+    1. In **Value 2**, enter **X**. This is the highest classification of solar flare. In the next step, you will create two reports: one for X class solar flares, and one for all the smaller solar flares.
 1. You can now check that the node is working and returning the expected date: select **Test step** to run the node manually. n8n tests the data against the condition, and shows which results match true or false in the **OUTPUT** panel.
 
-/// note | Weeks without large solar flares
-In this tutorial, you are working with live date. If you find there aren't any X class solar flares when you run the workflow, try replacing **X** in **Value 2** with either **A**, **B**, **C**, or **M**. 
-///
+    /// note | Weeks without large solar flares
+    In this tutorial, you are working with live data. If you find there aren't any X class solar flares when you run the workflow, try replacing **X** in **Value 2** with either **A**, **B**, **C**, or **M**.
+    ///
 
-5. Once you are happy the node will return some events, you can close the node to return to the canvas.
+1. Once you are happy the node will return some events, you can close the node to return to the canvas.
 
-## Step six: Output data from your workflow
+## Step five: Output data from your workflow
 
-The last step of the workflow is to send the two reports about solar flares. For this example, you'll send data to [Postbin](https://www.toptal.com/developers/postbin/){:target=_blank .external-link}. Postbin is a service that receives data and displays it on a temporary web page. 
+The last step of the workflow is to send the two reports about solar flares. For this example, you'll send data to [Postbin](https://www.toptal.com/developers/postbin/){:target=_blank .external-link}. Postbin is a service that receives data and displays it on a temporary web page.
 
 1. On the If node, select the **Add node** <span class="inline-image">![Add node icon](/_images/try-it-out/add-node.png){.off-glb}</span> connector labeled **true**.
 1. Search for **PostBin**. n8n shows a list of nodes that match the search.
@@ -117,26 +118,47 @@ The last step of the workflow is to send the two reports about solar flares. For
 1. Now, configure the data to send to Postbin. Next to **Bin Content**, select the **Expression** tab (you will need to mouse-over the **Bin Content** for the tab to appear), then select the expand button <span class="inline-image">![Add node icon](/_images/common-icons/open-expression-editor.png){.off-glb}</span> to open the full expressions editor.
 1. Select **Current Node** > **Input Data** > **JSON** > **classType**. n8n adds the expression to the **Expression** editor, and displays a sample output.
 1. The expression is: `{{$json["classType"]}}`. Add a message to it, so that the full expression is:
+
     ```js
     There was a solar flare of class {{$json["classType"]}}
     ```
+
+    ![image showing the expression above generating output](/_images/try-it-out/tutorial-expression.png)
+
 1. Close the expressions editor to return to the node.
 1. Close the Postbin node to return to the canvas.
 1. Add another Postbin node, to handle the **false** output path from the If node:
     1. Hover over the Postbin node, then select **Node context menu** <span class="inline-image">![Node context menu icon](/_images/common-icons/node-context-menu.png){.off-glb}</span> > **Duplicate node** to duplicate the first Postbin node.
     2. Drag the **false** connector from the If node to the left side of the new Postbin node.
 
-## Step seven: Test the workflow
+## Step six: Test the workflow
 
 1. You can now test the entire workflow. Select **Test Workflow**. n8n runs the workflow, showing each stage in progress.
-2. Go back to your Postbin bin. Refresh the page to see the output.
-3. If you want to use this workflow (in other words, if you want it to run once a week automatically), you need to activate it by selecting the **Active** toggle.
+1. Go back to your Postbin bin. Refresh the page to see the output.
+1. If you want to use this workflow (in other words, if you want it to run once a week automatically), you need to activate it by selecting the **Active** toggle.
 
 /// note | Time limit
 Postbin's bins exist for 30 minutes after creation. You may need to create a new bin and update the ID in the Postbin nodes, if you exceed this time limit.
 ///
 
+
+## Congratulations
+
+You now have a fully functioning workflow that does something useful! It should look something like this:
+
+[[ workflowDemo("file:///try-it-out/quickstart/tutorial.json") ]]
+
+Along the way you have discovered:
+
+- How to find the nodes you want and join them together
+- How to use expressions to manipulate data
+- How to create credentials and attach them to nodes
+- How to use logic in your workflows
+
+There are plenty of things you could add to this (perhaps add some more credentials and a node to send you an email of the results), or maybe you have a specific project in mind. Whatever your next steps, the resources linked below should help.
+
 ## Next steps
 
-* Take n8n's [text courses](/courses/index.md) or [video courses](/video-courses.md).
-* Explore more examples in [workflow templates](https://n8n.io/workflows/){:target=_blank .external-link}.
+- Interested in what you could do with AI? Find out [how to build an AI chat agent with n8n](/advanced-ai/intro-tutorial.md).
+- Take n8n's [text courses](/courses/index.md) or [video courses](/video-courses.md).
+- Explore more examples in [workflow templates](https://n8n.io/workflows/){:target=_blank .external-link}.


Reviews:
user: login: imchairmanm
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T10:51:38Z
user: login: imchairmanm
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T10:54:37Z
user: login: imchairmanm
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T10:57:23Z
user: login: imchairmanm
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T11:00:09Z
user: login: imchairmanm
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T11:03:24Z
user: login: imchairmanm
body: Left a few small notes, but looks good :+1: 
state: APPROVED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T11:06:12Z
user: login: evilnick
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T17:36:30Z
user: login: evilnick
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T17:41:33Z
user: login: evilnick
state: COMMENTED
author_association: CONTRIBUTOR
submitted_at: 2025-03-14T17:48:48Z

Review comments:
diff_hunk: @@ -6,8 +6,8 @@ contentType: overview
 
 # Try it out
 
-This section gets you up and running with building workflows in n8n.
+The best way to learn n8n is by using our tutorials to get familiar with the user interface and the many different types of nodes and integrations available. Here is a selection of material to get you started:
 
-* Want a fast taster of n8n? Try the [Very quick quickstart](/try-it-out/quickstart.md).
-* Looking for a more detailed introduction? Check out the [Slightly longer introduction](/try-it-out/longer-introduction.md).
-* Prefer to work through extensive examples? Maybe the [courses](/courses/index.md) are for you.
+- Looking for a more detailed introduction? Check out the [Slightly longer introduction](/try-it-out/longer-introduction.md).
path: docs/try-it-out/index.md
user: login: imchairmanm
body: We might want to change this description since it seems like a reference to the other quickstart.
created_at: 2025-03-14T10:51:38Z
author_association: CONTRIBUTOR
diff_hunk: @@ -4,36 +4,36 @@ description: Quickstart covering key concepts in n8n.
 contentType: tutorial
 ---
 
-# A slightly longer introduction
+# Your first workflow
 
-This guide shows you how to automate a task using a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
+This guide will show you how to construct a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
 
-* Create a workflow from scratch. You'll build a workflow that runs every week to get data from NASA, filters the data, and generates two reports.
+* Create a workflow from scratch. 
 * Understand key concepts and skills, including:
     * Starting workflows with trigger nodes
     * Configuring [credentials](/glossary.md#credential-n8n)
-    * Manipulating data
+    * Processing data
     * Representing logic in an n8n workflow
     * Using [expressions](/glossary.md#expression-n8n)
 
+This quickstart uses [n8n Cloud](/manage-cloud/overview.md), which is recommended for new users. A free trial is available - if you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
 
-## Step one: Sign up for n8n
+## Step one: Create a new workflow
 
-This quickstart uses [n8n Cloud](/manage-cloud/overview.md). A free trial is available for new users. If you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
+When you open n8n, you'll see either:
 
-## Step two: New workflow
+* An empty workflow: if you have no workflows and you're logging in for the first time. Use this workflow.
path: docs/try-it-out/longer-introduction.md
user: login: imchairmanm
body: I actually didn't see either of these on the account I created recently. Instead, there was a page with a button to either start from scratch or do something with an AI workflow. (it doesn't seem to drop you onto a blank canvas anymore).
created_at: 2025-03-14T10:54:36Z
author_association: CONTRIBUTOR
diff_hunk: @@ -4,36 +4,36 @@ description: Quickstart covering key concepts in n8n.
 contentType: tutorial
 ---
 
-# A slightly longer introduction
+# Your first workflow
 
-This guide shows you how to automate a task using a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
+This guide will show you how to construct a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
 
-* Create a workflow from scratch. You'll build a workflow that runs every week to get data from NASA, filters the data, and generates two reports.
+* Create a workflow from scratch. 
 * Understand key concepts and skills, including:
     * Starting workflows with trigger nodes
     * Configuring [credentials](/glossary.md#credential-n8n)
-    * Manipulating data
+    * Processing data
     * Representing logic in an n8n workflow
     * Using [expressions](/glossary.md#expression-n8n)
 
+This quickstart uses [n8n Cloud](/manage-cloud/overview.md), which is recommended for new users. A free trial is available - if you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
 
-## Step one: Sign up for n8n
+## Step one: Create a new workflow
 
-This quickstart uses [n8n Cloud](/manage-cloud/overview.md). A free trial is available for new users. If you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
+When you open n8n, you'll see either:
 
-## Step two: New workflow
+* An empty workflow: if you have no workflows and you're logging in for the first time. Use this workflow.
+* The **Workflows** list on the **Overview** page. Select the <span class="inline-image">![universal create resource icon](/_images/common-icons/universal-resource-button.png){.off-glb}</span> **button** to create a new workflow.
 
---8<-- "_snippets/try-it-out/new-workflow.md"
 
-
-## Step three: Add a trigger node
+## Step two: Add a trigger node
 
 n8n provides two ways to start a workflow:
 
-* Manually, by selecting **Test Workflow**, or from the CLI if you installed n8n with npm or Docker.
+* Manually, by selecting **Test Workflow** (or from the CLI if you installed n8n with Docker).
path: docs/try-it-out/longer-introduction.md
user: login: imchairmanm
body: I wonder if we should even mention the CLI at this point. That seems like such a niche for this level of introduction.
created_at: 2025-03-14T10:57:23Z
author_association: CONTRIBUTOR
diff_hunk: @@ -44,22 +44,22 @@ For this tutorial, use the [Schedule trigger](/integrations/builtin/core-nodes/n
 7. Close the node details view to return to the canvas.
 
 
-## Step four: Add the NASA node and set up credentials
+## Step three: Add the NASA node and set up credentials
 
-The [NASA node](/integrations/builtin/app-nodes/n8n-nodes-base.nasa.md) allows you to interact with NASA's [public APIs](https://api.nasa.gov/){:target=_blank .external-link}. The API gives you data to work with in this tutorial.
+The [NASA node](/integrations/builtin/app-nodes/n8n-nodes-base.nasa.md) interacts with NASA's [public APIs](https://api.nasa.gov/){:target=_blank .external-link} to fetch useful data. We will use the real-time data from the API to find solar events.
 
 1. Select the **Add node** <span class="inline-image">![Add node icon](/_images/try-it-out/add-node-small.png){.off-glb}</span> connector on the Schedule Trigger node.
-2. Search for **NASA**. n8n shows a list of nodes that match the search.
-3. Select **NASA** to view a list of operations.
-4. Search for and select **Get a DONKI solar flare**. This operation returns a report about recent solar flares. When you select the operation, n8n adds the node to the canvas and opens it.
-5. To access the NASA APIs, you need to set up credentials:
+1. Search for **NASA**. n8n shows a list of nodes that match the search.
+1. Select **NASA** to view a list of operations.
+1. Search for and select **Get a DONKI solar flare**. This operation returns a report about recent solar flares. When you select the operation, n8n adds the node to the canvas and opens it.
+1. To access the NASA APIs, you need to set up credentials:
     1. Select the  **Credential for NASA API** dropdown.
     2. Select **- Create New -**. n8n opens the credentials view.
-    3. Go to [NASA APIs](https://api.nasa.gov/){:target=_blank .external-link} and fill out the form in **Generate API Key**. NASA generates the key and displays it.
-    4. Copy the key, and paste it into **API Key** in n8n.
+    3. Go to [NASA APIs](https://api.nasa.gov/){:target=_blank .external-link} and fill out the form from the **Generate API Key** link. The NASA site generates the key and emails it to the address yopu entered.
path: docs/try-it-out/longer-introduction.md
user: login: imchairmanm
body: ```suggestion
    3. Go to [NASA APIs](https://api.nasa.gov/){:target=_blank .external-link} and fill out the form from the **Generate API Key** link. The NASA site generates the key and emails it to the address you entered.
```
created_at: 2025-03-14T11:00:09Z
author_association: CONTRIBUTOR
diff_hunk: @@ -44,22 +44,22 @@ For this tutorial, use the [Schedule trigger](/integrations/builtin/core-nodes/n
 7. Close the node details view to return to the canvas.
 
 
-## Step four: Add the NASA node and set up credentials
+## Step three: Add the NASA node and set up credentials
 
-The [NASA node](/integrations/builtin/app-nodes/n8n-nodes-base.nasa.md) allows you to interact with NASA's [public APIs](https://api.nasa.gov/){:target=_blank .external-link}. The API gives you data to work with in this tutorial.
+The [NASA node](/integrations/builtin/app-nodes/n8n-nodes-base.nasa.md) interacts with NASA's [public APIs](https://api.nasa.gov/){:target=_blank .external-link} to fetch useful data. We will use the real-time data from the API to find solar events.
 
 1. Select the **Add node** <span class="inline-image">![Add node icon](/_images/try-it-out/add-node-small.png){.off-glb}</span> connector on the Schedule Trigger node.
-2. Search for **NASA**. n8n shows a list of nodes that match the search.
-3. Select **NASA** to view a list of operations.
-4. Search for and select **Get a DONKI solar flare**. This operation returns a report about recent solar flares. When you select the operation, n8n adds the node to the canvas and opens it.
-5. To access the NASA APIs, you need to set up credentials:
+1. Search for **NASA**. n8n shows a list of nodes that match the search.
+1. Select **NASA** to view a list of operations.
+1. Search for and select **Get a DONKI solar flare**. This operation returns a report about recent solar flares. When you select the operation, n8n adds the node to the canvas and opens it.
+1. To access the NASA APIs, you need to set up credentials:
     1. Select the  **Credential for NASA API** dropdown.
path: docs/try-it-out/longer-introduction.md
user: login: imchairmanm
body: If we're updating to use `1.` for all of the numbers, we might want to change this list too.
created_at: 2025-03-14T11:03:23Z
author_association: CONTRIBUTOR
diff_hunk: @@ -4,36 +4,36 @@ description: Quickstart covering key concepts in n8n.
 contentType: tutorial
 ---
 
-# A slightly longer introduction
+# Your first workflow
 
-This guide shows you how to automate a task using a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
+This guide will show you how to construct a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
 
-* Create a workflow from scratch. You'll build a workflow that runs every week to get data from NASA, filters the data, and generates two reports.
+* Create a workflow from scratch. 
 * Understand key concepts and skills, including:
     * Starting workflows with trigger nodes
     * Configuring [credentials](/glossary.md#credential-n8n)
-    * Manipulating data
+    * Processing data
     * Representing logic in an n8n workflow
     * Using [expressions](/glossary.md#expression-n8n)
 
+This quickstart uses [n8n Cloud](/manage-cloud/overview.md), which is recommended for new users. A free trial is available - if you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
 
-## Step one: Sign up for n8n
+## Step one: Create a new workflow
 
-This quickstart uses [n8n Cloud](/manage-cloud/overview.md). A free trial is available for new users. If you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
+When you open n8n, you'll see either:
 
-## Step two: New workflow
+* An empty workflow: if you have no workflows and you're logging in for the first time. Use this workflow.
+* The **Workflows** list on the **Overview** page. Select the <span class="inline-image">![universal create resource icon](/_images/common-icons/universal-resource-button.png){.off-glb}</span> **button** to create a new workflow.
 
---8<-- "_snippets/try-it-out/new-workflow.md"
 
-
-## Step three: Add a trigger node
+## Step two: Add a trigger node
 
 n8n provides two ways to start a workflow:
 
-* Manually, by selecting **Test Workflow**, or from the CLI if you installed n8n with npm or Docker.
+* Manually, by selecting **Test Workflow** (or from the CLI if you installed n8n with Docker).
path: docs/try-it-out/longer-introduction.md
user: login: evilnick
body: yes, i had the same thought. Will remove
created_at: 2025-03-14T17:36:30Z
author_association: CONTRIBUTOR
diff_hunk: @@ -6,8 +6,8 @@ contentType: overview
 
 # Try it out
 
-This section gets you up and running with building workflows in n8n.
+The best way to learn n8n is by using our tutorials to get familiar with the user interface and the many different types of nodes and integrations available. Here is a selection of material to get you started:
 
-* Want a fast taster of n8n? Try the [Very quick quickstart](/try-it-out/quickstart.md).
-* Looking for a more detailed introduction? Check out the [Slightly longer introduction](/try-it-out/longer-introduction.md).
-* Prefer to work through extensive examples? Maybe the [courses](/courses/index.md) are for you.
+- Looking for a more detailed introduction? Check out the [Slightly longer introduction](/try-it-out/longer-introduction.md).
path: docs/try-it-out/index.md
user: login: evilnick
body: I swear i changed that already. Maybe I was dreaming
created_at: 2025-03-14T17:41:32Z
author_association: CONTRIBUTOR
diff_hunk: @@ -4,36 +4,36 @@ description: Quickstart covering key concepts in n8n.
 contentType: tutorial
 ---
 
-# A slightly longer introduction
+# Your first workflow
 
-This guide shows you how to automate a task using a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
+This guide will show you how to construct a [workflow](/glossary.md#workflow-n8n) in n8n, explaining key concepts along the way. You will:
 
-* Create a workflow from scratch. You'll build a workflow that runs every week to get data from NASA, filters the data, and generates two reports.
+* Create a workflow from scratch. 
 * Understand key concepts and skills, including:
     * Starting workflows with trigger nodes
     * Configuring [credentials](/glossary.md#credential-n8n)
-    * Manipulating data
+    * Processing data
     * Representing logic in an n8n workflow
     * Using [expressions](/glossary.md#expression-n8n)
 
+This quickstart uses [n8n Cloud](/manage-cloud/overview.md), which is recommended for new users. A free trial is available - if you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
 
-## Step one: Sign up for n8n
+## Step one: Create a new workflow
 
-This quickstart uses [n8n Cloud](/manage-cloud/overview.md). A free trial is available for new users. If you haven't already done so, [sign up](https://app.n8n.cloud/register) for an account now.
+When you open n8n, you'll see either:
 
-## Step two: New workflow
+* An empty workflow: if you have no workflows and you're logging in for the first time. Use this workflow.
path: docs/try-it-out/longer-introduction.md
user: login: evilnick
body: Thanks!
created_at: 2025-03-14T17:48:47Z
author_association: CONTRIBUTOR

PR comments:
user: login: netlify[bot]
created_at: 2025-03-14T01:50:06Z
body: ### <span aria-hidden="true">✅</span> Deploy Preview for *n8n-docs* ready!


|  Name | Link |
|:-:|------------------------|
|<span aria-hidden="true">🔨</span> Latest commit | 973984613cf57de942880e9ac09d2a6eff995109 |
|<span aria-hidden="true">🔍</span> Latest deploy log | https://app.netlify.com/sites/n8n-docs/deploys/67d46dd3774c8a0008392fb0 |
|<span aria-hidden="true">😎</span> Deploy Preview | [https://deploy-preview-2964--n8n-docs.netlify.app](https://deploy-preview-2964--n8n-docs.netlify.app) |
|<span aria-hidden="true">📱</span> Preview on mobile | <details><summary> Toggle QR Code... </summary><br /><br />![QR Code](https://app.netlify.com/qr-code/eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJ1cmwiOiJodHRwczovL2RlcGxveS1wcmV2aWV3LTI5NjQtLW44bi1kb2NzLm5ldGxpZnkuYXBwIn0.nMmv9NpXULIwZ-YmvJioYSbB3c5dHTLKHbGyLRwqGgE)<br /><br />_Use your smartphone camera to open QR code link._</details> |
---
<!-- [n8n-docs Preview](https://deploy-preview-2964--n8n-docs.netlify.app) -->
_To edit notification comments on pull requests, go to your [Netlify site configuration](https://app.netlify.com/sites/n8n-docs/configuration/notifications#deploy-webhooks)._
author_association: NONE
user: login: evilnick
created_at: 2025-03-14T01:50:28Z
body: @imchairmanm I have some screenshots to add at appropriate places but you can review the text anyhow ;)
author_association: CONTRIBUTOR
user: login: github-actions[bot]
created_at: 2025-03-14T01:50:37Z
body: <!-- **/*.md-code-coverage-assistant -->
**Overall readability score:** 44.72 (🟢 +0)

File | Readability
--- | ---
[longer-introduction.md](https://github.com/n8n-io/n8n-docs/blob/973984613cf57de942880e9ac09d2a6eff995109/docs/try-it-out/longer-introduction.md "docs/try-it-out/longer-introduction.md") | 81.97 (🔴 -0.24)
[index.md](https://github.com/n8n-io/n8n-docs/blob/973984613cf57de942880e9ac09d2a6eff995109/docs/try-it-out/index.md "docs/try-it-out/index.md") | 77.69 (🔴 -3.4)


<details>
  <summary>View detailed metrics</summary>

🟢 - Shows an _increase_ in readability
🔴 - Shows a _decrease_ in readability

File | Readability | FRE | GF | ARI | CLI | DCRS
--- | --- | --- | --- | --- | --- | ---
[longer-introduction.md](https://github.com/n8n-io/n8n-docs/blob/973984613cf57de942880e9ac09d2a6eff995109/docs/try-it-out/longer-introduction.md "docs/try-it-out/longer-introduction.md") | 81.97 | 66.03 | 7.09 | 8.2 | 8.75 | 5.98
&nbsp; | 🔴 -0.24 | 🟢 +0.2 | 🔴 -0.04 | 🟢 +0 | 🔴 -0.17 | 🟢 +0.01
[index.md](https://github.com/n8n-io/n8n-docs/blob/973984613cf57de942880e9ac09d2a6eff995109/docs/try-it-out/index.md "docs/try-it-out/index.md") | 77.69 | 69.79 | 10 | 6 | 7.51 | 7.49
&nbsp; | 🔴 -3.4 | 🔴 -3.34 | 🔴 -4 | 🟢 +0.3 | 🟢 +1.37 | 🟢 +0.51


Averages:

&nbsp; | Readability | FRE | GF | ARI | CLI | DCRS
--- | --- | --- | --- | --- | --- | ---
Average | 44.72 | 36.08 | 11.54 | 14.54 | 14.22 | 8.39
&nbsp; | 🟢 +0 | 🟢 +0.01 | 🟢 +0 | 🟢 +0 | 🟢 +0 | 🟢 +0


<details>
  <summary>View metric targets</summary>

Metric | Range | Ideal score
--- | --- | ---
Flesch Reading Ease | 100 (very easy read) to 0 (extremely difficult read) | 60
Gunning Fog | 6 (very easy read) to 17 (extremely difficult read) | 8 or less
Auto. Read. Index | 6 (very easy read) to 14 (extremely difficult read) | 8 or less
Coleman Liau Index | 6 (very easy read) to 17 (extremely difficult read) | 8 or less
Dale-Chall Readability | 4.9 (very easy read) to 9.9 (extremely difficult read) | 6.9 or less

</details>

</details>

author_association: NONE
user: login: github-actions[bot]
created_at: 2025-03-14T17:57:08Z
body: [Full Github Actions output](https://github.com/n8n-io/n8n-docs/actions/runs/13862515986?check_suite_focus=true)

<!-- thollander/actions-comment-pull-request "execution" -->
author_association: NONE