Merge branch 'cloudflare:production' into feature/content-version-management-system

Author: shinchan79

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/domain-support/remove-custom-hostnames.mdx

@@ -26,7 +26,7 @@ If the custom hostname is in a **Moved** state for seven days, it will transitio
 
 If your customer's domain is not using Cloudflare, you must remove a customer's custom hostname from your zone if they decide to churn.
 
-This is especially important if your end customers are using Cloudflare because if the custom hostname changes the DNS target to point away from your SaaS zone, the custom hostname will continue to route to your service. This is a result of the [custom hostname priority logic](/ssl/reference/certificate-and-hostname-priority/#hostname-priority-cloudflare-for-saas).
+This is especially important if your end customers are using Cloudflare because if the custom hostname changes the DNS target to point away from your SaaS zone, the custom hostname will continue to route to your service. This is a result of the [custom hostname priority logic](/ssl/reference/certificate-and-hostname-priority/#hostname-priority).
 
 <Tabs syncKey="dashPlusAPI"> <TabItem label="Dashboard">
 

src/content/docs/cloudflare-for-platforms/cloudflare-for-saas/reference/troubleshooting.mdx

@@ -33,7 +33,7 @@ There are three main causes of error 1016:
 
 1. Custom Hostname ownership validation is not complete. To check validation status, run an API call to [search for a certificate by hostname](/cloudflare-for-platforms/cloudflare-for-saas/start/common-api-calls/) and check the verification error field: `"verification_errors": ["custom hostname does not CNAME to this zone."]`.
 2. Fallback Origin is not [correctly set](/cloudflare-for-platforms/cloudflare-for-saas/start/getting-started/#1-create-fallback-origin). Confirm that you have created a DNS record for the fallback origin and also set the fallback origin.
-3. A Wildcard Custom Hostname has been created, but the requested hostname is associated with a domain that exists in Cloudflare as a standalone zone. In this case, the [hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority-cloudflare-for-saas) for the standalone zone will take precedence over the wildcard custom hostname. This behavior applies even if there is no DNS record for this standalone zone hostname.
+3. A Wildcard Custom Hostname has been created, but the requested hostname is associated with a domain that exists in Cloudflare as a standalone zone. In this case, the [hostname priority](/ssl/reference/certificate-and-hostname-priority/#hostname-priority) for the standalone zone will take precedence over the wildcard custom hostname. This behavior applies even if there is no DNS record for this standalone zone hostname.
 
 In this scenario each hostname that needs to be served by the Cloudflare for SaaS parent zone needs to be added as an individual Custom Hostname.
 

src/content/docs/dns/manage-dns-records/index.mdx

@@ -6,11 +6,40 @@ sidebar:
 
 ---
 
-import { DirectoryListing, FeatureTable, GlossaryTooltip } from "~/components"
+import { DirectoryListing, FeatureTable, GlossaryTooltip, Details, Example } from "~/components"
 
 DNS records contain information about your domain and are used to make your website or application available to visitors and other web services.
 
-For background about different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/).
+Depending on the providers you used to [get your domain name](/fundamentals/setup/manage-domains/#get-a-domain-name) and [host your website or application](/fundamentals/setup/manage-domains/#host-your-domain), it is expected that DNS records were automatically created on your behalf. According to your [setup](/dns/get-started/), you can use Cloudflare to manage your DNS records.
+
+## DNS records table
+
+DNS records have different types and each type serves a different purpose. For background about the different types of DNS records, refer to the [Learning Center](https://www.cloudflare.com/learning/dns/dns-records/). To quickly find reference information about a specific type refer to [DNS record types](/dns/manage-dns-records/reference/dns-record-types/).
+
+When managing your records at Cloudflare, besides the common record fields described below, you may also find an option for [Proxy status](/dns/manage-dns-records/reference/proxied-dns-records/) and [CNAME flattening](/dns/cname-flattening/). These are specific features offered by Cloudflare.
+
+<Details header="Record fields">
+- **Type**: Defines the purpose of a record. Different types of record require different information in their corresponding `Content` field.
+- **Name**: Identifies the resource that the record resolves to. Depending on the purpose of the record, the value you want to add to this field will also change.
+- **Content**: Contains the core value of a record, depending on the record type.
+- **TTL**: Controls how long each record is cached by DNS resolvers.
+</Details>
+
+<Details header="Example">
+
+<Example>
+DNS management for **example.com**:
+
+| Type | Name    | Content      | Proxy status | TTL    |
+| ---- | ------- | ------------ | ------------ | ------ |
+| A    | `blog`  | `192.0.2.1`  | Proxied      | Auto   |
+
+In this example, an IP address resolution record of type `A` is indicating that the resources that correspond to the subdomain `blog.example.com` can be reached on the IPv4 address `192.0.2.1`.
+
+Also, as this record is <GlossaryTooltip term="proxy status" link="/dns/manage-dns-records/reference/proxied-dns-records/">proxied</GlossaryTooltip>, Cloudflare automatically defines for how long this information should be cached by DNS resolvers.
+</Example>
+
+</Details>
 
 ## DNS records quota
 

src/content/docs/rules/url-forwarding/bulk-redirects/how-it-works.mdx

@@ -6,6 +6,8 @@ sidebar:
   label: How it works
 ---
 
+import { MetaInfo } from "~/components";
+
 For each incoming request, Cloudflare evaluates all URL redirects of each Bulk Redirect List that is enabled by a Bulk Redirect Rule.
 
 If there is a match for a URL redirect according to the URL matching algorithm, the redirect action is performed immediately, according to the URL redirect configuration parameters. Cloudflare performs no further processing once a redirect action has been executed.
@@ -14,27 +16,25 @@ If there is a match for a URL redirect according to the URL matching algorithm,
 
 The following URL redirect parameters control the matching behavior between the request URL and source URLs of the configured (and enabled) URL redirects:
 
-- **Subpath matching** (default: false)
-
-  - If true, the URL redirect will apply to all paths under the given source path. For example, consider the following source and target URLs of a URL redirect:
+- **Subpath matching** <MetaInfo text="(default: false)"/>
 
-    — Source URL: `https://example.com/foo/`
+  - If `true`, the URL redirect will apply to all paths under the given source path. For example, consider the following source and target URLs of a URL redirect:
 
-    — Target URL: `https://example.com/qux/`
+    - Source URL: `https://example.com/foo/`
+    - Target URL: `https://example.com/qux/`
 
   - With this configuration and **Subpath matching** enabled, an incoming request to `example.com/foo/bar` will be redirected to `https://example.com/qux/bar`.
 
   :::note
   URL redirects with **Subpath matching** enabled cannot contain more than 16 `/` (slash) characters in the source URL path.
   :::
 
-- **Include subdomains** (default: false)
-
-  - If true, the source URL hostname of the URL redirect will also apply to all its subdomains. For example, consider the following source and target URLs of a URL redirect:
+- **Include subdomains** <MetaInfo text="(default: false)"/>
 
-    — Source URL: `https://example.com/about`
+  - If `true`, the source URL hostname of the URL redirect will also apply to all its subdomains. For example, consider the following source and target URLs of a URL redirect:
 
-    — Target URL: `https://example.com/newpage`
+    - Source URL: `https://example.com/about`
+    - Target URL: `https://example.com/newpage`
 
   - With this configuration and **Includes subdomains** enabled, incoming requests to `http://a.example.com/about` and `http://a.b.example.com/about` would also match, in addition to the specified domain with no subdomain (`https://example.com/about`).
 
@@ -44,29 +44,27 @@ For detailed information on these parameters, refer to [URL redirect parameters]
 
 The following parameters configure how Cloudflare determines the path and query string of the final target URL:
 
-- **Preserve query string** (default: false)
+- **Preserve query string** <MetaInfo text="(default: false)"/>
 
-  - If true, the final target URL will keep the query string of the original request. For example, consider the following source and target URLs of a URL redirect:
+  - If `true`, the final target URL will keep the query string of the original request. For example, consider the following source and target URLs of a URL redirect:
 
-    — Source URL: `https://example.com/about`
-
-    — Target URL: `https://example.com/newpage`
+    - Source URL: `https://example.com/about`
+    - Target URL: `https://example.com/newpage`
 
   - With this configuration and **Preserve query string** enabled, an incoming request to `http://example.com/about?q=term` would be redirected to `https://example.com/newpage?q=term`. If **Preserve query string** is disabled, the same incoming request would be redirected to `https://example.com/newpage`.
 
-- **Preserve path suffix** (default: true)
+- **Preserve path suffix** <MetaInfo text="(default: true)"/>
 
   - Defines if the final target URL will include the parts of the request path that did not match the URL redirect's source URL.
 
   - When **Subpath matching** is enabled, the path that was not matched is copied over to the final target URL. For example, consider the following source and target URLs of a URL redirect:
 
-    — Source URL: `https://example.com/a/`
-
-    — Target URL: `https://example.com/b/`
+    - Source URL: `https://example.com/a/`
+    - Target URL: `https://example.com/b/`
 
   - An incoming request to `https://example.com/a/foo` will be redirected to `https://example.com/b/foo`.
 
-  - If you set **Preserve path suffix** to false, the same request will still match the redirect, but it will be redirected to `https://example.com/b/`.
+  - If you set **Preserve path suffix** to `false`, the same request will still match the redirect, but it will be redirected to `https://example.com/b/`.
 
 For detailed information on these parameters, refer to [URL redirect parameters](/rules/url-forwarding/bulk-redirects/reference/parameters/).
 

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

@@ -5,54 +5,78 @@ sidebar:
   order: 3
 ---
 
+import { Type, MetaInfo } 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.
 
-The URL redirect parameters are the following:
+## Source URL
+
+API field: `source_url` <Type text="String" />
+
+The URL string that the incoming request URL must match for the redirect to be applied. This property is mandatory. The maximum length of the source URL is 32 KB.
+
+The value must be a valid URL, but the URL scheme is not required (for example, `https`); when the scheme is omitted, the redirect applies to both `http` and `https` URL schemes.
+
+A Bulk Redirect List cannot contain several URL redirects with the exact same source URL.
+The exact behavior of the [URL matching algorithm](/rules/url-forwarding/bulk-redirects/how-it-works/#url-matching-algorithm), which matches an incoming request with the redirect's source URL, depends on the values of the [**Include subdomains**](#include-subdomains) and [**Subpath matching**](#subpath-matching) parameters.
+
+For more information on the supported URL components, refer to [Supported URL components](/rules/url-forwarding/bulk-redirects/reference/url-components/).
+
+## Target URL
+
+API field: `target_url` <Type text="String" />
+
+The URL where the client will be redirected to when there is a match for the URL redirect. This property is mandatory. The maximum length of the target URL is 32 KB.
+
+The value must be a valid URL. The final target URL depends on the values of the [**Preserve query string**](#preserve-query-string) and [**Preserve path suffix**](#preserve-path-suffix) parameters.
+
+For more information on the supported URL components, refer to [Supported URL components](/rules/url-forwarding/bulk-redirects/reference/url-components/).
+
+## Subpath matching
+
+API field: `subpath_matching` <Type text="Boolean" /> <MetaInfo text="default: false" />
+
+If `true`, the current redirect will apply the subpath matching algorithm to the request URL when determining if there is a match for the current URL redirect.
+
+For example, a URL redirect from `/my-folder/` to `/other-folder/` with **Subpath matching** enabled will also redirect a request from `/my-folder/item` to `/other-folder/item`. However, the redirect will only include the `item` part when [**Preserve path suffix**](#preserve-path-suffix) is `true`.
+
+For more information, refer to [Matching the source URL of redirects](/rules/url-forwarding/bulk-redirects/how-it-works/#matching-the-source-url-of-redirects).
+
+## Include subdomains
+
+API field: `include_subdomains` <Type text="Boolean" /> <MetaInfo text="default: false" />
+
+If `true`, the source URL hostname will also apply to any subdomains — the redirect will match for all subdomains to the left of the domain portion of the source URL, as well as the specified domain.
+
+For example, a redirect with source URL defined as `http://example.com/about` will also apply to requests with source URL `http://a.example.com/about` or `http://a.b.example.com/about`.
 
-- **Source URL** (String)
+For more information, refer to [Matching the source URL of redirects](/rules/url-forwarding/bulk-redirects/how-it-works/#matching-the-source-url-of-redirects).
 
-  - API field name: `source_url`.
-  - The URL string that the incoming request URL must match for the redirect to be applied. This property is mandatory. The maximum length of the source URL is 32 KB.
-  - The value must be a valid URL, but the URL scheme is not required (for example, `https`); when the scheme is omitted, the redirect applies to both `http` and `https` URL schemes.
-  - A Bulk Redirect List cannot contain several URL redirects with the exact same source URL.
-  - The exact behavior of the [URL matching algorithm](/rules/url-forwarding/bulk-redirects/how-it-works/#url-matching-algorithm), which matches an incoming request with the redirect’s source URL, depends on the values of the **Include subdomains** and **Subpath matching** parameters.
-  - For more information on the supported URL components, refer to [Supported URL components](/rules/url-forwarding/bulk-redirects/reference/url-components/).
+## Preserve query string
 
-- **Target URL** (String)
+API field: `preserve_query_string` <Type text="Boolean" /> <MetaInfo text="default: false" />
 
-  - API field name: `target_url`.
-  - The URL where the client will be redirected to when there is a match for the URL redirect. This property is mandatory. The maximum length of the target URL is 32 KB.
-  - The value must be a valid URL. The final target URL depends on the values of the **Preserve query string** and **Preserve path suffix** parameters.
-  - For more information on the supported URL components, refer to [Supported URL components](/rules/url-forwarding/bulk-redirects/reference/url-components/).
+If `true`, the redirect URL will keep the query string of the original request.
 
-- **Subpath matching** (Boolean)
+For example, a URL redirect from `/my-folder/` to `/other-folder/` with **Preserve query string** enabled will redirect a request from `/my-folder/?name=value` to `/other-folder/?name=value`. If **Preserve query string** is disabled, the request will be redirected from `/my-folder/?name=value` to `/other-folder/`.
 
-  - API field name: `subpath_matching`.
-  - If true, the current redirect will apply the subpath matching algorithm to the request URL when determining if there is a match for the current URL redirect. The default value is `false`.
-  - For example, a URL redirect from `/my-folder/` to `/other-folder/` with **Subpath matching** enabled will also redirect a request from `/my-folder/item` to `/other-folder/item`. However, the redirect will only include the `item` part when **Preserve path suffix** is true. Refer to **Preserve path suffix** for details.
-  - For more information, refer to [Matching the source URL of redirects](/rules/url-forwarding/bulk-redirects/how-it-works/#matching-the-source-url-of-redirects).
+## Preserve path suffix
 
-- **Include subdomains** (Boolean)
+API field: `preserve_path_suffix` <Type text="Boolean" /> <MetaInfo text="default: true" />
 
-  - API field name: `include_subdomains`.
-  - If true, the source URL hostname will also apply to any subdomains — the redirect will match for all subdomains to the left of the domain portion of the source URL, as well as the specified domain. The default value is `false`.
-  - For example, a redirect with source URL defined as `http://example.com/about` will also apply to requests with source URL `http://a.example.com/about` or `http://a.b.example.com/about`.
-  - For more information, refer to [Matching the source URL of redirects](/rules/url-forwarding/bulk-redirects/how-it-works/#matching-the-source-url-of-redirects).
+Applicable only when [**Subpath matching**](#subpath-matching) is enabled. If `true`, defines that the redirect URL will include the remaining (non-matched) path elements of the source URL, if any.
 
-- <a name="preserve-query-string"></a> **Preserve query string** (Boolean)
+For example, when both **Subpath matching** and **Preserve path suffix** are enabled, a URL redirect from `/my-folder/` to `/another-folder/` will redirect an incoming request from `/my-folder/foo` to `/another-folder/foo`. If **Preserve path suffix** is disabled, the same request would still match the URL redirect, but it would redirect from `/my-folder/foo` to `/another-folder/`.
 
-  - API field name: `preserve_query_string`.
-  - If true, the redirect URL will keep the query string of the original request. The default value is `false`.
-  - For example, a URL redirect from `/my-folder/` to `/other-folder/` with **Preserve query string** enabled will redirect a request from `/my-folder/?name=value` to `/other-folder/?name=value`. If **Preserve query string** is disabled, the request will be redirected from `/my-folder/?name=value` to `/other-folder/`.
+## Status code
 
-- **Preserve path suffix** (Boolean)
+API field: `status_code` <Type text="Integer" /> <MetaInfo text="default: 301" />
 
-  - API field name: `preserve_path_suffix`.
-  - Applicable only when **Subpath matching** is enabled. If true, defines that the redirect URL will include the remaining (non-matched) path elements of the source URL, if any. The default value is `true`.
-  - For example, when both **Subpath matching** and **Preserve path suffix** are enabled, a URL redirect from `/my-folder/` to `/another-folder/` will redirect an incoming request from `/my-folder/foo` to `/another-folder/foo`. If **Preserve path suffix** is disabled, the same request would still match the URL redirect, but it would redirect from `/my-folder/foo` to `/another-folder/`.
+The HTTP status code returned to the client when redirecting.
 
-- **Status code** (Integer)
+The value must be one of the following:
 
-  - API field name: `status_code`.
-  - The HTTP status code returned to the client when redirecting. The default value is `301`.
-  - The value must be one of the following: `301` (Moved permanently), `302` (Found, also known as Moved temporarily), `307` (Temporary redirect), or `308` (Permanent redirect).
+- `301` (Moved permanently)
+- `302` (Found, also known as Moved temporarily)
+- `307` (Temporary redirect)
+- `308` (Permanent redirect)