Reorganize Transform Rules documentation (#1671)

* Move files to new structure
* Update content of Transform Rules documentation
* Rename Welcome article to Overview

Author: pedrosousa

products/rules/src/content/index.md

@@ -3,13 +3,13 @@ pcx-content-type: landing-page
 order: 1
 ---
 
-# Welcome
+# Overview
 
-With Rules you can manage the following types of rules:
+With Rules, you can manage the following types of rules:
 
-- **Page Rules** - Allow you to control which Cloudflare settings trigger on a given URL. Learn about Page Rules in the [Support KB](https://support.cloudflare.com/hc/articles/218411427).
+* **Page Rules** — Allow you to control which Cloudflare settings trigger on a given URL. Learn about Page Rules in the [Support KB](https://support.cloudflare.com/hc/articles/218411427).
 
-- [**Transform Rules**](/transform) - Allow you to make adjustments to incoming requests at the edge before they go through any other Cloudflare products.
+* [**Transform Rules**](/transform) — Allow you to make adjustments to incoming requests at the edge before they go through any other Cloudflare products.
 
 <Aside type='note' header='Note'>
 

products/rules/src/content/transform/api/index.md

@@ -23,59 +23,12 @@ There are two types of Transform Rules:
 To configure Transform Rules in the dashboard, use the **Transform Rules** tab in Rules.
 
 <ButtonGroup>
-  <Button type="primary" href="/transform/create-url-rewrite-rule">Create a URL Rewrite Rule</Button>
-  <Button type="primary" href="/transform/create-header-modification-rule">Create a Header Modification Rule</Button>
-  <Button type="secondary" href="/transform/use-cases">Examples</Button>
+  <Button type="primary" href="/transform/url-rewrite/create-dashboard">Create a URL Rewrite Rule</Button>
+  <Button type="primary" href="/transform/request-header-modification/create-dashboard">Create a Request Header Modification Rule</Button>
 </ButtonGroup>
 
 ---
 
-## URL Rewrite Rules
-
-A URL Rewrite Rule can perform a **static rewrite** or a **dynamic rewrite**. Static rewrites replace a given part of a request URL (path or query string) with a static string. Dynamic rewrites support more advanced scenarios where you use an [expression](https://developers.cloudflare.com/firewall/cf-firewall-rules/fields-and-expressions) to define the resulting path or query string.
-
-To create a URL Rewrite Rule in the dashboard, see [Create a URL Rewrite Rule in the dashboard](/transform/create-url-rewrite-rule).
-
-To create a URL Rewrite Rule via API, see [Create a URL Rewrite Rule via API](/transform/api/url-rewrite-rule).
-
-### Rewrites and redirects
-
-You can manipulate the URL of a request through different operations, namely through rewrites and redirects. 
-
-A **rewrite** is a server-side operation that occurs before a web server has fully processed a request. A rewrite is not visible to website visitors, since the URL displayed in the browser does not change. 
-
-A **redirect** is a client-side operation that occurs after the web server has loaded the initial URL. In this case, a website visitor can see the URL changing when the redirect occurs.
-
-You can configure URL Rewrite Rules in the dashboard to perform rewrites at the edge without reaching your web server. URL Rewrite Rules run in the `http_request_transform` phase of Cloudflare's request handling workflow. For more information on phases, check the [Ruleset Engine](https://developers.cloudflare.com/firewall/cf-rulesets) documentation.
-
-Check [Configuring URL forwarding or redirects with Cloudflare Page Rules](https://support.cloudflare.com/hc/articles/200172286) in the Support KB to learn more about configuring redirects.
-
----
-
-## HTTP Request Header Modification Rules
-
-You can manipulate the headers of incoming HTTP requests through HTTP Request Header Modification Rules. Through these rules you can:
-
-* Set the value of an HTTP request header to a literal string value, overwriting its previous value or adding a new header to the request.
-* Set the value of an HTTP request header according to an expression, overwriting its previous value or adding a new header to the request.
-* Remove an HTTP request header from the request (remove all headers with the provided name).
-
-<Aside type='warning' header='Important'>
-
-* You cannot modify or remove HTTP request headers whose name starts with `cf-` or `x-cf-` except for the `cf-connecting-ip` HTTP request header, which you can remove.
-
-* If you modify the value of an existing HTTP request header using an expression that evaluates to an empty string (`""`) or an undefined value, the HTTP request header is **removed**.
-
-</Aside>
-
-HTTP Request Header Modification Rules run in the `http_request_late_transform` phase of Cloudflare's request handling workflow. For more information on phases, see [Phases](https://developers.cloudflare.com/firewall/cf-rulesets#phases) in the Ruleset Engine documentation.
-
-To create an HTTP Request Header Modification Rule in the dashboard, see [Create an HTTP Request Header Modification Rule in the dashboard](/transform/create-header-modification-rule).
-
-To create an HTTP Request Header Modification Rule via API, see [Create an HTTP Request Header Modification Rule via API](/transform/api/header-modification-rule).
-
----
-
 ## Availability
 
 Cloudflare Transform Rules are available to all customers. Keep in mind that support for regular expressions is based on your plan type.
@@ -99,11 +52,12 @@ A Cloudflare user must have the [Firewall role](https://support.cloudflare.com/h
 
 To get started building your own Transform Rules, see:
 
-* [Create a URL Rewrite Rule](/transform/create-url-rewrite-rule)
-* [Create an HTTP Request Header Modification Rule](/transform/create-header-modification-rule)
+* [Create a URL Rewrite Rule in the dashboard](/transform/url-rewrite/create-dashboard)
+* [Create an HTTP Request Header Modification Rule in the dashboard](/transform/request-header-modification/create-dashboard)
 
-You can also [create Transform Rules via API](/transform/api).
+You can also create Transform Rules via API:
 
-For common Transform Rule scenarios, see [Common use cases](/transform/use-cases).
+* [Create a URL Rewrite Rule via API](/transform/url-rewrite/create-api)
+* [Create an HTTP Request Header Modification Rule via API](/transform/request-header-modification/create-api)
 
 Check [Firewall Rules language](https://developers.cloudflare.com/firewall/cf-firewall-language) for more information on building expressions for Transform Rules, since the language is the same as the Firewall Rules language.

products/rules/src/content/transform/create-header-modification-rule.md

@@ -22,8 +22,8 @@ The **Transform Rules** dashboard interface lets you:
 
 In the **Transform Rules** tab you can:
 
-* [Create a URL Rewrite Rule](/transform/create-url-rewrite-rule)
-* [Create an HTTP Request Header Modification Rule](/transform/create-header-modification-rule)
+* [Create a URL Rewrite Rule](/transform/url-rewrite/create-dashboard)
+* [Create an HTTP Request Header Modification Rule](/transform/request-header-modification/create-dashboard)
 
 See each linked section for details on creating each rule type.
 

products/rules/src/content/transform/index.md

@@ -1,20 +1,21 @@
 ---
-title: Create a Request Header Modification Rule
-pcx-content-type: interim
+title: Create a rule via API
+pcx-content-type: how-to
+type: overview
 order: 2
 ---
 
 # Create an HTTP Request Header Modification Rule via API
 
-Use the [Rulesets API](https://developers.cloudflare.com/firewall/cf-rulesets/rulesets-api) to create HTTP Request Header Modification Rules via API. Define the header modification configuration in the `action_parameters` field. See [Common use cases](/transform/use-cases#http-request-header-modification-examples) for example rule definitions.
+Use the [Rulesets API](https://developers.cloudflare.com/firewall/cf-rulesets/rulesets-api) to create HTTP Request Header Modification Rules via API. Define the header modification configuration in the `action_parameters` field. See [Request header modification examples](/transform/request-header-modification/examples) for examples of rule definitions.
 
 When creating an HTTP Request Header Modification Rule via API, make sure you:
 
 * Set the rule action to `rewrite`
-* Define the [header modification parameters](#header-modification-parameters) in the `action_parameters` field according to the operation to perform (set or remove header)
+* Define the [header modification parameters](/transform/request-header-modification/reference/parameters) in the `action_parameters` field according to the operation to perform (set or remove header)
 * Deploy the rule to the `http_request_late_transform` phase at the zone level
 
-## Create an HTTP Request Header Modification Rule
+---
 
 Follow this workflow to create an HTTP Request Header Modification Rule for a given zone via API:
 
@@ -257,87 +258,3 @@ header: Response
 
 </div>
 </details>
-
----
-
-## Header modification parameters
-
-To set an HTTP request header, set the following parameters in the `action_parameters` field:
-
-* **operation**: `set`
-* Include one of the following parameters to define a static or dynamic value:
-
-    * **value**: Specifies a static value for the HTTP request header.
-    * **expression**: Specifies the expression that defines a value for the HTTP request header.
-
-To remove an HTTP request header, set the following parameter in the `action_parameters` field:
-
-* **operation**: `remove`
-
-### Static header value parameters
-
-The full syntax of the `action_parameters` field to define a static HTTP request header value is the following:
-
-```json
-"action_parameters": {
-  "headers": {
-    "<HEADER_NAME>": {
-      "operation": "set",
-      "value": "<URI_PATH_VALUE>"
-    }
-  }
-}
-```
-
-### Dynamic header value parameters
-
-The full syntax of the `action_parameters` field to define a dynamic HTTP request header value using an expression is the following:
-
-```json
-"action_parameters": {
-  "headers": {
-    "<HEADER_NAME>": { 
-      "operation": "set",
-      "expression": "<EXPRESSION>"
-    }
-  }
-}
-```
-
-<Aside type='note'>
-
-Check the [available fields and functions](/transform/create-header-modification-rule#available-fields-and-functions) you can use in an expression.
-
-</Aside>
-
-### Header removal parameters
-
-The full syntax of the `action_parameters` field to remove an HTTP request header is the following:
-
-```json
-"action_parameters": {
-  "headers": {
-    "<HEADER_NAME>": { 
-      "operation": "remove"
-    }
-  }
-}
-```
-
-### Different header modifications in the same rule
-
-The same rule can modify different HTTP request headers using different operations (set or remove a header). For example, a single rule can set the value of a header and remove a different header. The syntax of such a rule could be the following:
-
-```json
-"action_parameters": {
-  "headers": {
-    "<HEADER_NAME_1>": { 
-      "operation": "set",
-      "value": "<HEADER_VALUE_1>"
-    }, 
-    "<HEADER_NAME_2>": {
-      "operation": "remove"
-    }
-  }
-}
-```