Maddy

This commit performs a **documentation update** for the **Cloudflare One Email Security** section, specifically reordering the display of email dispositions. It moves the descriptions for 'Suspicious' and 'Spoof' dispositions to appear after 'Bulk' in relevant lists and explanations. This change affects the `auto-moves` settings documentation (`src/content/docs/cloudflare-one/email-security/settings/auto-moves.mdx`) and the shared `dispositions-and-attributes` partial (`src/content/partials/cloudflare-one/email-security/dispositions-and-attributes.mdx`). The primary scope is to enhance the **readability and logical consistency of the Email Security documentation** for users configuring these settings.

This commit **updates the documentation** for **Cloudflare One Email Security's auto-moves settings**, specifically within the `auto-moves.mdx` file. It adds crucial clarification regarding the availability of specific deletion actions, detailing that 'Soft delete - user recoverable' is available for Microsoft 365 and 'Move to trash' for Google Workspace users. This **documentation enhancement** ensures users have a clearer understanding of provider-specific options when configuring email security policies. The change improves the user experience by providing more precise guidance on the **Email Security** feature.

This commit performs a **documentation improvement** by **standardizing the representation of `try...catch`** across several guides. It updates code examples and text formatting within the **Durable Objects best practices**, **Sandbox guides** (backup/restore, file watching, mount buckets), and **Stream video transformation bindings** documentation. This **maintenance** work ensures consistent syntax and presentation of error handling mechanisms. The changes enhance the clarity and readability of the documentation, providing a uniform learning experience for developers interacting with these platform features.

This commit **updates the Email Security documentation** by replacing the existing feature comparison table within the `cloudflare-one` section. The new table in `src/content/docs/cloudflare-one/email-security/setup/index.mdx` now specifically focuses on **email providers**, offering a more relevant comparison for users. This **documentation improvement** also includes clarifying notes regarding different deployment types and message modification capabilities within the Email Security offering. This ensures users have a clearer and more focused understanding of the service's features and setup options.

This commit delivers significant **documentation updates** for **Cloudflare Email Security**, focusing on enhancing clarity and conciseness across several key areas. It **improves existing content** within the `cloudflare-one/email-security` module, specifically rephrasing the introductory overview, "Run screens," and "Recommendations" sections in `index.mdx`. The documentation for the **Retro Scan feature** in `retro-scan.mdx` was also rephrased for better understanding, and the `egress-ips.mdx` file received expanded and clarified instructions for configuring egress IPs, particularly for Microsoft 365. This **maintenance** work aims to make the **Email Security setup and features** more accessible and easier for users to comprehend.

This commit **improves the documentation** for the **Cloudflare Network Firewall's packet capture feature**. It provides **clarified explanations** for both full and sample packet captures within `src/content/docs/cloudflare-network-firewall/packet-captures/index.mdx`. This **documentation update** details their definitions, intended uses, underlying purpose, inherent limitations, and how data is collected, making the complex topic more accessible and understandable for users. The change enhances the user experience by providing clearer guidance on leveraging this critical **network security** tool.

This commit provides a **documentation update** for the **Cloudflare Network Firewall**'s troubleshooting guide. It specifically enhances the `diagnose-traffic-decisions.mdx` page by adding a crucial note to the packet capture instructions. This **maintenance** change informs users that packet capture files might occasionally be empty, improving clarity and preventing potential confusion during the diagnostic process for Network Firewall traffic.

This commit **updates the documentation** for the **Cloudflare Network Firewall**, specifically enhancing the `index.mdx` overview page. It **improves clarity** by simplifying the main product description and providing a more accessible explanation of the rules language. Additionally, the description for the **Intrusion Detection System (IDS)** feature has been expanded to offer more comprehensive details. This **documentation improvement** aims to make the **Network Firewall** easier to understand for new and existing users.

[Email security] Make language consistent (#29073)

This commit **updates documentation** for **Email security**, specifically clarifying the behavior and requirements of **auto-moves** and **PhishGuard**. It adds a crucial warning to `phishguard.mdx` stating that auto-moves are mandatory for PhishGuard customers. Additionally, the `auto-moves.mdx` page has been rephrased to improve readability and clarify descriptions of auto-move actions, enhancing user understanding of these security features. This **documentation update** aims to simplify the user experience and ensure customers are aware of critical configuration requirements for email security features.

This commit **updates the Cloudforce One documentation** (`src/content/docs/security-center/cloudforce-one/index.mdx`) to include comprehensive new sections. It provides detailed guidance on analyzing threat events, identifying adversaries, searching for indicators, and receiving alerts. This **documentation update** also covers using the `Cloudy` tool for analysis, significantly enhancing user understanding of **Cloudforce One's threat intelligence and management capabilities**. The content was refined to accurately reflect released features, specifically removing mentions of unreleased notification functionality.

This commit introduces a **new troubleshooting guide** within the **Cloudflare Network Firewall documentation** to assist users in diagnosing traffic decisions. The new page, `diagnose-traffic-decisions.mdx`, provides detailed information on understanding why specific traffic is allowed or blocked by the firewall. This **documentation enhancement** also establishes a new `troubleshooting` index page and includes necessary updates to sidebar navigation for improved content discoverability. Ultimately, this work aims to empower users with better self-service tools for understanding and resolving Network Firewall behavior.

This commit primarily **updates and expands the Brand Protection documentation**, specifically detailing **self-serve checkout** capabilities, user permissions, and various query types. It enhances the definition of Brand Protection to cover proactive impersonation and phishing identification, including examples like typosquatting and homoglyph attacks. This is a **documentation update** and **maintenance** effort, which also includes minor reformatting of code blocks in the `Intune MDM deployment guide` and syntax updates in the `Privacy Proxy observability reference`. The changes improve the clarity and completeness of critical user-facing information for the **Brand Protection** feature.

This commit **enhances** the **Security overview documentation** by expanding the content within `src/content/docs/security/overview.mdx`. It specifically adds more detailed lists for `insight types` and `security categories`, providing a more comprehensive resource for users. This **documentation update** improves the clarity and completeness of information regarding the project's security features and classifications.

This commit **enhances the Security Center's documentation** by refreshing the **Security Overview page**. It introduces new sections on 'Security action items', 'Detection tools', and 'Traffic overview' within `src/content/docs/security/overview.mdx`, alongside refining existing content. This **documentation update** provides users with more comprehensive and up-to-date information, significantly improving clarity and guidance on the platform's security capabilities.

This commit **standardizes the naming convention** for the **Cloudflare Advanced Network Firewall** across various documentation pages. It consistently updates the phrasing from "Advanced Cloudflare Network Firewall" to the correct "Cloudflare Advanced Network Firewall" throughout the content. This **documentation update** primarily affects guides related to creating rate-limiting policies, enabling IDS, and collecting packet captures within the `cloudflare-network-firewall` and `cloudflare-one` sections, as well as a changelog entry. The change ensures consistent terminology, improving clarity and accuracy for users interacting with these features.

This commit **improves the documentation** for the **Brand Protection** feature, specifically enhancing the clarity around **logo matching** capabilities. It renames "Logo queries" to the more descriptive "**Logo search (AI-powered)**" within the `src/content/docs/security-center/brand-protection.mdx` file. Additionally, the update provides crucial details on how to configure the **match threshold** for logo searches, ensuring users can effectively utilize and fine-tune this security feature. This **documentation update** helps users better understand and leverage the AI-powered logo detection system.

This commit **updates the documentation** for **abuse reporting**, specifically within the `src/content/docs/fundamentals/reference/report-abuse/submit-report.mdx` file. It **adds a crucial paragraph** that explains the process for requesting a review of a mitigation following an abuse allegation. This **documentation enhancement** improves clarity for users by providing comprehensive guidance on the post-allegation review procedure. The change ensures that users understand the full lifecycle of an abuse report, including options for mitigation review.

This commit performs a **documentation update** for the **Email Security** product, specifically **removing all mentions and detailed explanations** of "Post-delivery response" (PDR) and "Phish submission response" (PSR) features. The changes span multiple **Cloudflare One documentation** files, including the general setup overview and checklist (`src/content/docs/cloudflare-one/email-security/setup/index.mdx`), auto-moves configuration guides (`src/content/docs/cloudflare-one/email-security/settings/auto-moves.mdx`), and related learning paths for securing email (`src/content/docs/learning-paths/secure-your-email/`). This **maintenance** task ensures the documentation accurately reflects the current feature set and terminology within the **Email Security** offering.

This commit introduces a **new documentation page** detailing **best practices** for configuring **Email Security detection settings** within the Cloudflare One product. This **documentation update** provides crucial guidance, empowering users to optimize their email security configurations effectively. The new page, located at `src/content/docs/cloudflare-one/email-security/settings/detection-settings/best-practices.mdx`, enhances the overall user experience by offering clear, actionable recommendations.