Skip to content

[Precursor] Updating Changelog for Precursor - release 6 July#31816

Open
marinaelmore wants to merge 13 commits into
cloudflare:productionfrom
marinaelmore:SHIP-14230/precursor-changelog
Open

[Precursor] Updating Changelog for Precursor - release 6 July#31816
marinaelmore wants to merge 13 commits into
cloudflare:productionfrom
marinaelmore:SHIP-14230/precursor-changelog

Conversation

@marinaelmore

@marinaelmore marinaelmore commented Jun 30, 2026

Copy link
Copy Markdown
Collaborator

Summary

Adding changelog for Precursor.

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 12 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
…sing link to blog that will be released on 6 July
@marinaelmore marinaelmore requested review from a team and elithrar as code owners June 30, 2026 19:33
@cloudflare-docs-bot

cloudflare-docs-bot Bot commented Jun 30, 2026

Copy link
Copy Markdown
Contributor

Review

⚠️ 5 warnings, 💡 4 suggestions found in full PR diff.

Code Review

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

Warnings (2)
File Issue
changelog/cloudflare-challenges/2026-06-30-precursor-session-based-detection.mdx line 9 Placeholder URL in published content — The announcement blog link uses https://blog.cloudflare.com/placeholder-precursor-announcement/, which is a placeholder URL that will 404 when published. Fix: Replace the placeholder with the real announcement blog URL before releasing this changelog.
cloudflare-challenges/challenge-types/challenge-pages/index.mdx line 8 Duplicate sidebar order — Both challenge-pages/index.mdx and challenge-pages/create-custom-rule.mdx set sidebar.order: 2, so the two sibling pages can render in an unstable/ambiguous order. Fix: Use a unique sidebar.order for the overview, e.g. 1, and adjust the other page if needed.

Conventions

Checks PR title, description, and redirect checklist.

No convention issues found.

Style Guide Review

Warnings (3)
File Issue
cloudflare-challenges/precursor.mdx line 17 Bulleted list used for sequential steps — Line 17 starts a bulleted list describing the Precursor verification loop steps Fix: Use a numbered list for sequential steps
cloudflare-challenges/precursor.mdx line 27 Use turn on / turn off for toggles — Line adds 'Enable Precursor for your zone:' Fix: Change to 'Turn on Precursor for your zone:'
cloudflare-challenges/precursor.mdx line 60 Use turn on / turn off for toggles — Line adds 'Rules do not enable or disable Precursor' Fix: Change to 'Rules do not turn Precursor on or off'
Suggestions (4)
File Issue
cloudflare-challenges/precursor.mdx line 64 Bullet list has fewer than three items — Line 64 begins a two-item bullet list of example rules Fix: Consider writing the two examples as prose
cloudflare-challenges/precursor.mdx line 79 Bullet list has fewer than three items — Line 79 begins a two-item bullet list comparing Challenges and Precursor Fix: Consider writing the comparison as prose
cloudflare-challenges/concepts/clearance.mdx line 21 Bullet list has fewer than three items — Two-item bullet list introduces Challenge clearance and Precursor clearance Fix: Rewrite the two items as prose or expand the list to three or more items
cloudflare-challenges/concepts/clearance.mdx line 55 Bullet list has fewer than three items — Two-item bullet list describes Precursor suspicious session consequences Fix: Rewrite the two items as prose or expand the list to three or more items

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

Copy link
Copy Markdown
Collaborator Author

/full-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