Rebecca Tamachiro

This commit **updates the documentation** for the **Cloudflare Workers runtime API**, specifically revising the stated **maximum WebSocket message size limit**. The `src/content/docs/workers/runtime-apis/websockets.mdx` file now accurately reflects an increase from 1 MiB to **32 MiB**. This **documentation update** ensures developers have correct information regarding WebSocket capabilities, preventing potential confusion and enabling them to utilize the enhanced message size support in their **Workers applications**.

This commit significantly **improves the clarity, accuracy, and consistency of the DNS troubleshooting documentation**. It involves **updating stale information**, refining explanations for various DNS issues like `DNS_PROBE_FINISHED_NXDOMAIN` and CNAME flattening, and enhancing readability across numerous pages within the `dns` documentation. The work includes **content updates**, **stylistic refactoring**, and **bug fixes** for outdated terminology and grammatical errors, leveraging glossary components for better understanding. This comprehensive **documentation maintenance** effort ensures users have access to more precise and user-friendly guides for resolving DNS-related problems.

This commit **updates the GPG key name** within the project's documentation, specifically for **Cloudflare One Tunnel** `cloudflared` Debian installation and **SSL Keyless Key Server setup**. This **documentation maintenance** ensures that users reference the most recent GPG key, changing it from `cloudflare-public-v2.gpg` to `cloudflare-main.gpg`. The update prevents potential issues with package validation or trust for users following these critical installation and setup guides.

This commit significantly **improves the DNS documentation** by adding critical information and clarifying existing content. It introduces a new section in `update-nameservers.mdx` detailing options for **restricted nameserver management** and provides other content updates to enhance user guidance. Additionally, the `domain-status.mdx` file is updated with a **caution note regarding nameserver assignment for re-added domains** and improved formatting. This **documentation enhancement** aims to prevent common user pitfalls and ensure more accurate and comprehensive information for managing DNS nameservers and understanding domain statuses.

This commit delivers several **documentation improvements and fixes** across the project. It **corrects an incorrect video ID** in the `onboard-domain-cf` stream configuration (`index.yaml`), ensuring users are directed to the proper onboarding video for Cloudflare domains. Additionally, it **fixes placeholder notation** in a `curl` command example within the `third-party-load-balancers.mdx` troubleshooting guide, enhancing the clarity and correctness of the provided code snippet. Finally, a **new reference architecture diagram** is listed on the `by-solution.mdx` page, expanding the available architectural guidance. These changes collectively improve the accuracy and completeness of the project's documentation.

This commit introduces **new documentation** to assist users in **troubleshooting issues** related to **third-party load balancers** when integrated with Cloudflare. A new page, `src/content/docs/support/troubleshooting/general-troubleshooting/third-party-load-balancers.mdx`, has been added to provide specific guidance, including updated examples for scenarios like F5 BIG-IP cookie persistence. This **support content enhancement** improves the project's **documentation** by offering clear steps and updated example values for common configuration problems. The addition provides valuable resources for users encountering connectivity or persistence issues with external load balancing solutions.

This commit **introduces a new documentation page** detailing the **Distributed Web Performance Architecture**. It adds a comprehensive overview to the `reference-architecture` section, specifically within `src/content/docs/reference-architecture/diagrams/content-delivery/distributed-web-performance-architecture.mdx`, explaining the goals, key metrics, data flow, and relevant tools for optimizing web performance. This **new content** provides valuable insights into the system's design, enhancing the project's **architectural documentation** for users and contributors. The work involved extensive content migration, file renaming, and multiple rounds of text review to ensure accuracy and adherence to style guidelines.

This commit provides a comprehensive **review and refinement of the `add-site` documentation**, significantly improving the clarity and flow for users onboarding new domains. It involves **reordering sections**, clarifying instructions for DNS setup, SSL/TLS, and proxy status, and updating internal references across several **DNS-related partials**. This **documentation improvement** aims to enhance the user experience by making critical information more accessible and understandable, ultimately streamlining the process of adding a site and configuring its domain. Key areas like DNSSEC notes, nameserver updates, and CNAME warnings are made more prominent and actionable.

This commit provides a **documentation fix** for the **DNS record types reference**, specifically addressing the **CNAME record examples**. It **corrects an error** where a CNAME example incorrectly used 'A' as the record type instead of 'CNAME' within the `src/content/docs/dns/manage-dns-records/reference/dns-record-types.mdx` file. Additionally, the commit adjusts code block highlighting ranges in the same document to improve presentation and readability. This **maintenance** task ensures that users referencing the **DNS documentation** receive accurate and well-formatted information regarding CNAME record configuration.

This commit significantly **improves the documentation** for the **Cloudflare Registrar** by making the **Cloudflare nameserver requirement more visible and understandable**. It **updates** the `src/content/docs/registrar/get-started/register-domain.mdx` guide with a prominent note and **expands** the `src/content/docs/registrar/faq.mdx` with new sections on domain management and nameservers. This **documentation enhancement** aims to provide clearer guidance for users, ensuring they are aware of essential setup steps and improving the overall onboarding experience for the Registrar service.

This commit performs a significant **refactoring and consolidation** of the **SSL/TLS documentation**, primarily revamping the FAQ structure. It introduces a **new consolidated SSL/TLS FAQ page** (`ssl/faq.mdx`), migrating questions from various previous locations, deleting redundant pages, and re-arranging content for improved organization. This **documentation maintenance** effort also includes updating numerous links across **Cloudflare for Platforms**, **Fundamentals**, and **WAF** modules to point to the new, correct locations for SSL/TLS and CAA records information. Additionally, it incorporates **content enhancements** like new sections on SEO, OCSP/HTTP versions, and specific troubleshooting, alongside the creation of **redirects** in `public/__redirects` to ensure link integrity and a seamless user experience.

This commit significantly **optimizes the DNS documentation** to enhance clarity and user experience, particularly for nameserver updates and full zone setups. It involves **restructuring content** across `faq.mdx`, `update-nameservers.mdx`, and the `full-setup` guides, utilizing collapsible 'Details' components and numbered headings for better organization. The changes aim to **reduce jargon, improve searchability**, and provide a more intuitive flow for users configuring their DNS settings. This comprehensive **documentation improvement** makes critical setup processes more accessible and easier to follow.

This commit performs a **documentation update** by revising the **Sectigo documentation link** within the project's **SSL reference materials**. Specifically, the `src/content/docs/ssl/reference/certificate-authorities.mdx` file is updated to direct users to the new **Sectigo resource library** for browser compatibility information. This **maintenance** task ensures that users consulting the **certificate authorities documentation** are provided with accurate and current external resources, enhancing the overall reliability of the project's documentation.

This commit performs a significant **documentation enhancement and refactoring** within the **DNSSEC section**, aiming to provide more comprehensive and organized information. A **new documentation file**, `validation-and-key-management.mdx`, is introduced to detail DNSSEC validation, chain of trust, and key management, including automatic DS record updates and DNSKEY flags. Concurrently, the `multi-signer-dnssec/about.mdx` file is updated with new sections explaining multi-signer DNSSEC behavior and best practices. This **documentation update** improves user understanding of complex DNSSEC configurations and operational procedures.

This commit **corrects documentation** for **SSL edge certificates**, specifically removing an erroneous requirement regarding the order of intermediate and leaf certificates in user-defined bundles. The file `src/content/docs/ssl/edge-certificates/custom-certificates/bundling-methodologies.mdx` is updated to reflect that any order will work, simplifying the bundling methodology. This **documentation update** prevents user confusion and streamlines the process for configuring custom SSL certificates by clarifying that the previously stated order dependency is not necessary.

This commit significantly **enhances the SSL/mTLS documentation** to provide more comprehensive information and improved debugging guidance for client certificate validation. It updates the **client-certificates overview** (`src/content/docs/ssl/client-certificates/index.mdx`) with details on the `cf.tls_client_auth.cert_verified` field and adds a "Further resources" section. The **troubleshooting guide** (`src/content/docs/ssl/client-certificates/troubleshooting.mdx`) now includes advice on disabling VPNs/proxies, clarifies `curl` command output, and introduces an advanced debugging section utilizing Cloudflare Workers. These **documentation improvements** aim to help users better understand and troubleshoot mTLS configurations and certificate validation issues.

This commit **updates the API deprecations documentation** within `src/content/release-notes/api-deprecations.yaml` to introduce **'Batch DNS records'** as the recommended alternative. This **documentation update** clarifies the new approach for changing DNS record types, guiding users away from deprecated methods. The change ensures that developers consulting the **API deprecations guide** have clear, up-to-date information for migrating their integrations and managing **DNS records** effectively.

This commit **updates API endpoint links** across several **Authenticated Origin Pull (AOP)** documentation pages. It specifically revises references within the `aws-alb-integration.mdx` guide, the `manage-certificates.mdx` section covering both zone and hostname-level operations, and the `per-hostname.mdx` setup instructions. This **documentation maintenance** also includes updating API links for listing and deleting hostname client certificates in the `aop-rollback-hostname-setup.mdx` partial. The changes ensure that users are directed to the correct and most current API resources for configuring AOP, alongside general text refinements to improve clarity.

This commit **enhances the DNS documentation** by clarifying the limits on NS records for a single delegation name. It introduces a **new documentation partial** (`ns-delegation-name-limit.mdx`) that details these constraints. This crucial information is then integrated into the `subdomains-outside-cloudflare.mdx` guide, which also receives updated examples, and referenced from the `dns-record-types.mdx` reference. This **documentation update** provides users with clearer guidance on **NS record delegation constraints**, improving their understanding of **DNS management**.

This commit provides a significant **documentation update** for the **DNS quick scan feature**, primarily affecting `src/content/docs/dns/zone-setups/reference/dns-quick-scan.mdx`. It **clarifies the availability and usage** of the quick scan by adding detailed examples, refining the `#limitations` section with improved wording, and linking to the full setup guide. Additionally, the `src/content/partials/dns/dns-scan-note.mdx` partial was updated to correct the API endpoint name and link for triggering a DNS records scan. These changes aim to **enhance user understanding** and improve the clarity of the DNS quick scan process.