[Rules] Snippets: Update dashboard instructions (#19511)

Author: pedrosousa

src/content/changelogs/rules.yaml

@@ -5,6 +5,10 @@ productLink: "/rules/"
 productArea: Application performance
 productAreaLink: /fundamentals/reference/changelog/performance/
 entries:
+  - publish_date: "2025-01-29"
+    title: New Snippets code editor
+    description: |-
+      The new Snippets code editor is now live, allowing users to edit both Snippets code and rules from a single page. This update simplifies the workflow and introduces features such as code formatting, refactoring, and auto-complete. The updated editor is available within the Snippets interface.
   - publish_date: "2025-01-09"
     title: New Rules Overview page
     description: |-

src/content/docs/rules/snippets/create-api.mdx

@@ -58,6 +58,8 @@ curl --request PUT https://api.cloudflare.com/client/v4/zones/{zone_id}/snippets
 --form metadata='{"main_module":"example.js"}'
 ```
 
+The name of a snippet can only contain the characters `a-z`, `0-9`, and `_` (underscore). The name must be unique in the context of the zone. You cannot change the snippet name after creating the snippet.
+
 The required body parameters are:
 
 - `files`: The file with your JavaScript code.
@@ -78,6 +80,8 @@ To make this example work, save your JavaScript code in a file named `example.js
 }
 ```
 
+To deploy a new snippet you must [create a snippet rule](#createupdatedelete-snippet-rules). The expression of the snippet rule defines when the snippet code will run.
+
 ### Create/update/delete snippet rules
 
 :::caution

src/content/docs/rules/snippets/create-dashboard.mdx

@@ -9,30 +9,20 @@ head:
     content: Create a snippet in the dashboard
 ---
 
-The snippet creation wizard will guide you through the following steps:
-
-1. Define snippet code and test your snippet.
-2. Create snippet rule. The rule expression defines for which requests the snippet code will run.
-3. Review your snippet configuration and deploy the snippet.
-
-## Procedure
-
 1. Log in to the [Cloudflare dashboard](https://dash.cloudflare.com/), and select your account and website.
 
 2. Go to **Rules** > **Snippets**, and select **Create a Snippet**.
 
-3. Enter a descriptive name for the snippet.
-
-4. Enter the snippet's JavaScript code. You can test how your snippet will handle incoming requests using the **HTTP** and **Preview** tabs.
+3. In **Snippet name**, enter a descriptive name for the snippet. You cannot change the name after creating the snippet.
 
-5. Select **Continue to add Snippet rule**.
+4. Enter the snippet's JavaScript code in the code editor. You can test how your snippet will handle incoming requests using the **HTTP** and **Preview** tabs.
 
-6. Enter a descriptive name for the snippet rule. The snippet rule specifies for which requests the snippet code will run.
+5. Select **Snippet rule** to configure when the snippet will run.
 
-7. Under **When incoming requests match**, select if you wish to run the snippet for all incoming requests or only for requests that match a custom filter expression.
+6. Under **Run this Snippet if incoming requests match**, select if you wish to run the snippet only for requests that match a custom filter expression or for all incoming requests.
 
-8. (Optional) To define a custom expression, use the Expression Builder (specifying one or more values for **Field**, **Operator**, and **Value**) or manually enter an expression using the Expression Editor. For more information, refer to [Edit expressions in the dashboard](/ruleset-engine/rules-language/expressions/edit-expressions/).
+7. (Optional) To define a custom expression, use the Expression Builder (specifying one or more values for **Field**, **Operator**, and **Value**) or manually enter an expression using the Expression Editor. For more information, refer to [Edit expressions in the dashboard](/ruleset-engine/rules-language/expressions/edit-expressions/).
 
-9. Select **Continue to create Snippet**.
+8. Select **Done**.
 
-10. Review the snippet code and the snippet rule that defines when the snippet will run. To save your snippet and deploy a rule that enables it, select **Save and deploy Snippet**. If you are not ready to deploy your snippet, select **Save and enable later**.
+9. To deploy your snippet, select **Deploy**. If you are not ready to deploy your snippet, open the dropdown next to **Deploy** and select **Save as Draft**.

src/content/docs/rules/snippets/create-terraform.mdx

@@ -40,7 +40,7 @@ resource "cloudflare_snippet_rules" "cookie_snippet_rule" {
 }
 ```
 
-The name of a snippet can only contain the characters `a-z`, `0-9`, and `_` (underscore). The name must be unique in the context of the zone.
+The name of a snippet can only contain the characters `a-z`, `0-9`, and `_` (underscore). The name must be unique in the context of the zone. You cannot change the snippet name after creating the snippet.
 
 All `snippet_name` values in the `cloudflare_snippet_rules` resource must match the names of existing snippets.
 

src/content/docs/rules/snippets/index.mdx

@@ -26,7 +26,7 @@ To create and deploy a Snippet, you need to define the following elements:
 - **Code snippet**: JavaScript code to be executed during the request-handling process.
 - **Snippet rule**: A [filter expression](/ruleset-engine/rules-language/expressions/) that determines which requests the Snippet will be applied to. Each Snippet can only be associated with one Snippet Rule.
 
-For more information, refer to the [How it works](/rules/snippets/how-it-works/) and [Create in the dashboard](/rules/snippets/create-dashboard/) sections.
+For more information, refer to the [How it works](/rules/snippets/how-it-works/) and [Create a snippet in the dashboard](/rules/snippets/create-dashboard/) sections.
 
 ## Templates