Skip to content

[CF1] ELI5 on CASB docs#29703

Open
Oxyjun wants to merge 3 commits intoproductionfrom
jun/eli5/casb
Open

[CF1] ELI5 on CASB docs#29703
Oxyjun wants to merge 3 commits intoproductionfrom
jun/eli5/casb

Conversation

@Oxyjun
Copy link
Copy Markdown
Contributor

@Oxyjun Oxyjun commented Apr 8, 2026

Fixes grammar, navigation path, and terminology inconsistencies across CASB documentation, identified during an ELI5 clarity review of the cloud-and-saas-findings/ folder.

  • Grammar fix (casb-dlp.mdx): "files stored in a SaaS application contains" → "contain" (subject-verb agreement).
  • Navigation path (troubleshoot-casb.mdx, integrations/.../casb.mdx): Changed **Integrations** > **Cloud & SaaS** to **Cloud & SaaS findings** > **Integrations** to match the canonical path used in manage-findings.mdx, casb-dlp.mdx, and the manage-integrations partial.
  • Toggle label (troubleshoot-casb.mdx, integrations/.../casb.mdx): Changed **Findings scanning** to **Scan for findings** to match the manage-integrations partial. Also removed an extra step ("Go to CASB") not present in the partial.
  • Terminology (troubleshoot-casb.mdx, integrations/.../casb.mdx): Replaced the undocumented "Suppress" action with a cross-link to the ignore/hide workflow documented in manage-findings.mdx.

Note: The toggle label ("Scan for findings" vs. "Findings scanning") should be verified against the current dashboard UI. This PR aligns with the manage-integrations partial, which is the most widely referenced source.

…istencies

- Fix subject-verb agreement in casb-dlp.mdx ('contains' -> 'contain')
- Align troubleshoot navigation path to canonical 'Cloud & SaaS findings > Integrations'
- Align toggle label to 'Scan for findings' per manage-integrations partial
- Replace undocumented 'Suppress' action with cross-link to ignore/hide workflow
- Apply same fixes to duplicate troubleshoot file in integrations folder
@github-actions
Copy link
Copy Markdown
Contributor

github-actions bot commented Apr 8, 2026

This pull request requires reviews from CODEOWNERS as it changes files that match the following patterns:

Pattern Owners
/src/content/docs/cloudflare-one/cloud-and-saas-findings/ @Maddy-Cloudflare, @codyanthony850, @cloudflare/pcx-technical-writing
/src/content/docs/cloudflare-one/ @ranbel, @Maddy-Cloudflare, @codyanthony850, @cloudflare/pcx-technical-writing

Oxyjun added 2 commits April 8, 2026 16:20
- Split long CASB intro sentence and explain 'API-driven' inline (index.mdx)
- Add DLP profile parenthetical definition (casb-dlp.mdx)
- Add caution callout for full-scan vs incremental-scan distinction (casb-dlp.mdx)
- Rephrase ambiguous Java/R minimum size limitation (casb-dlp.mdx)
- Add OCR cross-link to clarify that CASB does not scan images but DLP does via Gateway (casb-dlp.mdx)
- Add parenthetical for 'data at rest' (manage-findings.mdx)
- Add ignore vs hide comparison before procedures (manage-findings.mdx)
- Clarify Failed vs Rejected remediation statuses (manage-findings.mdx)
- Rewrite Gateway policy intro to bridge CASB-to-Gateway concept (manage-findings.mdx)
- Add finding ID location hint (troubleshoot-casb.mdx)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants