[Rules] Update redirect status codes (#29792)

Author: pedrosousa

src/content/docs/rules/url-forwarding/bulk-redirects/reference/parameters.mdx

@@ -5,7 +5,7 @@ sidebar:
   order: 3
 ---
 
-import { Type, MetaInfo } from "~/components";
+import { Type, MetaInfo, Render } from "~/components";
 
 A URL redirect has a source URL, a target URL, a status code, and some additional parameters that affect its URL matching behavior and runtime behavior.
 
@@ -70,13 +70,9 @@ For example, when both **Subpath matching** and **Preserve path suffix** are ena
 
 ## Status code
 
-API field: `status_code` <Type text="Integer" /> <MetaInfo text="default: 301" />
+API field: `status_code` <Type text="Integer" /> <MetaInfo text="default: 301" /><br/>
+API values: `301`, `302`, `307`, or `308`.
 
-The HTTP status code returned to the client when redirecting.
+The HTTP status code returned to the client when redirecting:
 
-The value must be one of the following:
-
-- `301` (Moved permanently)
-- `302` (Found, also known as Moved temporarily)
-- `307` (Temporary redirect)
-- `308` (Permanent redirect)
+<Render file="redirects-status-codes" product="rules" />

src/content/docs/rules/url-forwarding/single-redirects/settings.mdx

@@ -20,7 +20,9 @@ A wildcard URL redirect has the following configuration parameters:
 
 - **Target URL**: Enter the target URL, which can be static (for example, `https://example.com`) or dynamic (for example, `https://example.com/${1}/files/${2}`). Use [wildcard replacement](/ruleset-engine/rules-language/functions/#wildcard_replace) like `${1}`, `${2}`, etc., to define dynamic targets.
 
-- **Status code**: The HTTP status code of the redirect response (_301_ by default). Must be one of the following: _301_ (Moved permanently), _302_ (Found, also known as Moved temporarily), _307_ (Temporary redirect), or _308_ (Permanent redirect).
+- **Status code**: The HTTP status code of the redirect response (_301 - Permanent Redirect_ by default). Must be one of the following:
+
+  <Render file="redirects-status-codes" product="rules" />
 
 - **Preserve query string**: Whether to preserve the query string when redirecting (disabled by default).
 
@@ -32,7 +34,9 @@ A static URL redirect has the following configuration parameters:
 
 - **URL**: A literal string that will be used in the `Location` HTTP header returned in the redirect response.
 
-- **Status code**: The HTTP status code of the redirect response (_301_ by default). Must be one of the following: _301_ (Moved permanently), _302_ (Found, also known as Moved temporarily), _307_ (Temporary redirect), or _308_ (Permanent redirect).
+- **Status code**: The HTTP status code of the redirect response (_301 - Permanent Redirect_ by default). Must be one of the following:
+
+  <Render file="redirects-status-codes" product="rules" />
 
 - **Preserve query string**: Whether to preserve the query string when redirecting (disabled by default).
 
@@ -66,7 +70,9 @@ A dynamic URL redirect has the following configuration parameters:
 
 - **Expression**: An [expression](/ruleset-engine/rules-language/expressions/) that defines the target URL of the redirect. The result of evaluating this expression will be used in the `Location` HTTP header returned in the redirect response. Refer to the [fields](/ruleset-engine/rules-language/fields/reference/) and [functions](/ruleset-engine/rules-language/functions/) you can use in expressions.
 
-- **Status code**: The HTTP status code of the redirect response (_301_ by default). Must be one of the following: _301_ (Moved permanently), _302_ (Found, also known as Moved temporarily), _307_ (Temporary redirect), or _308_ (Permanent redirect).
+- **Status code**: The HTTP status code of the redirect response (_301 - Permanent Redirect_ by default). Must be one of the following:
+
+  <Render file="redirects-status-codes" product="rules" />
 
 - **Preserve query string**: Whether to preserve the query string when redirecting (disabled by default).
 

src/content/partials/rules/redirects-status-codes.mdx

@@ -0,0 +1,8 @@
+---
+{}
+---
+
+- **301 - Permanent Redirect**: The page has permanently moved to a new address. For `POST` requests, the client or browser might switch the HTTP method to `GET` when following the redirect.
+- **302 - Temporary Redirect**: The page has temporarily moved to a new address. For `POST` requests, the client or browser might switch the HTTP method to `GET` when following the redirect.
+- **307 - Advanced: Temporary, HTTP method preserved**: The page has temporarily moved to a new address. The client or browser must preserve the original HTTP method (for example, `POST`) when following the redirect.
+- **308 - Advanced: Permanent, HTTP method preserved**: The page has permanently moved to a new address. The client or browser must preserve the original HTTP method (for example, `POST`) when following the redirect.

src/content/partials/rules/url-forwarding/optional-parameters.mdx

@@ -1,9 +1,12 @@
 ---
 {}
-
 ---
 
 The optional parameters can have the following values:
 
-* `"status_code"` (integer): `301` (Moved permanently), `302` (Found, also known as Moved temporarily), `307` (Temporary redirect), or `308` (Permanent redirect).
-* `"preserve_query_string"` (boolean): `true` or `false`.
+- `"status_code"` (integer):
+  - `301` (permanent redirect)
+  - `302` (temporary redirect)
+  - `307` (temporary redirect, preserving original HTTP method)
+  - `308` (permanent redirect, preserving original HTTP method)
+- `"preserve_query_string"` (boolean): `true` or `false`