Skip to content

[Precursor] Add Precursor Dev Docs for Launch#31806

Open
marinaelmore wants to merge 11 commits into
cloudflare:productionfrom
marinaelmore:SHIP-14230/precursor-dev-docs
Open

[Precursor] Add Precursor Dev Docs for Launch#31806
marinaelmore wants to merge 11 commits into
cloudflare:productionfrom
marinaelmore:SHIP-14230/precursor-dev-docs

Conversation

@marinaelmore

@marinaelmore marinaelmore commented Jun 30, 2026

Copy link
Copy Markdown
Collaborator

Summary

Add dev docs for Precursor launch

Screenshots (optional)

Documentation checklist

  • Is there a changelog entry (guidelines)? If you don't add one for something awesome and new (however small) — how will our customers find out? Changelogs are automatically posted to RSS feeds, the Discord, and X.
  • The change adheres to the documentation style guide.
  • If a larger change - such as adding a new page- an issue has been opened in relation to any incorrect or out of date information that this PR fixes.
  • Files which have changed name or location have been allocated redirects.

marinaelmore and others added 8 commits June 23, 2026 16:53
Documents the zone-level surface where Precursor's detections appear
after enablement: Security > Analytics > Traffic > Bot analysis. The
bot score distribution and WAF rule-match counts there reflect
Precursor's behavioral and biometric signals.

Scoped to what is true at launch. The forthcoming Sessions tab is
intentionally not documented here yet because the style guide
(.semgrep/style-guide-dates-in-docs.yaml) discourages forward-looking
language. A follow-up edit will replace this section once the Sessions
tab ships.
[Challenges] Add Visibility in Security Analytics to Precursor
Five small fixes from a style guide pass:

- visitor's: straight apostrophe, not curly (line 11)
- Security > Settings: use the docs separator, not the unicode arrow (line 32)
- Turn on Precursor: matches the 'turn on / turn off' rule from the style guide (line 34)
- Image alt text on both images now describes what is shown
- Negative margin removed from the second image (the layout works without it)
[Challenges] Style guide fixups in precursor.mdx
@marinaelmore marinaelmore requested review from a team and elithrar as code owners June 30, 2026 14:28
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Review

💡 3 suggestions found in commit 10d2f5c.

Code Review

This code review is in beta and may not always be helpful — use your judgment.

No code review issues found.

Conventions

Checks PR title, description, and redirect checklist.

No convention issues found.

Style Guide Review

Suggestions (3)
File Issue
cloudflare-challenges/precursor.mdx line 42 Bulleted list has fewer than three items — Only two bullet items (Minimize Friction and Maximize Security) list the Precursor modes Fix: Consider rewriting the two mode descriptions as prose instead of a two-item bulleted list
cloudflare-challenges/precursor.mdx line 90 Passive voicePrecursor is tightly integrated with cf_clearance uses passive voice Fix: Rewrite in active voice, for example: Precursor integrates tightly with cf_clearance
cloudflare-challenges/concepts/clearance.mdx line 51 Passive voice — Sentence uses passive voice ('Precursor clearance is continuously re-evaluated', 'is updated dynamically') and could be more direct in active voice. Fix: Rewrite in active voice, for example: 'Precursor continuously re-evaluates clearance throughout a visitor's session...'

Redirects

No missing redirect entries found.

Commands

Only codeowners can run commands. Post a comment with the command to trigger it.

Command Description
/review Runs a review now. Incremental if a prior review exists, full if not.
/full-review Re-reviews the entire PR diff from scratch, ignoring incremental history. Useful after a rebase, when you want a fresh review, or if the bot gets out of sync and reports issues that no longer exist.
/ignore-review-limit Permanently lifts the 2-review automatic limit for this PR. Future pushes will trigger reviews as normal.
/disable-auto-review Stops automatic reviews from triggering on future pushes to this PR. Codeowners can still run /review or /full-review manually.

@marinaelmore marinaelmore changed the title Ship 14230/precursor dev docs [Precursor] Add Precursor Dev Docs for Launch Jun 30, 2026
@marinaelmore

Copy link
Copy Markdown
Collaborator Author

/review

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.

2 participants