Skip to content

docs(product): Update screenshots on Ownership Rules page - #18882

Merged
sfanahata merged 5 commits into
masterfrom
smi/chore/stale-image-18214
Jul 31, 2026
Merged

docs(product): Update screenshots on Ownership Rules page#18882
sfanahata merged 5 commits into
masterfrom
smi/chore/stale-image-18214

Conversation

@inventarSarah

@inventarSarah inventarSarah commented Jul 30, 2026

Copy link
Copy Markdown
Collaborator

DESCRIBE YOUR PR

the page: /product/issues/ownership-rules/

  • updated screenshots that were outdated
  • removed screenshots I felt were not needed
  • cleaned up some content in the "code owners" section that wasn't needed (because we linked to explanations on a different page)

I think this page needs some love (update content, structure, writing) @sfanahata

Closes: #18214

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.

  • Urgent deadline (GA date, etc.):
  • Other deadline:
  • None: Not urgent, can wait up to 1 week+

SLA

  • Teamwork makes the dream work, so please add a reviewer to your PRs.
  • Please give the docs team up to 1 week to review your PR unless you've added an urgent due date to it.
    Thanks in advance for your help!

PRE-MERGE CHECKLIST

Make sure you've checked the following before merging your changes:

  • Checked Vercel preview for correctness, including links
  • PR was reviewed and approved by any necessary SMEs (subject matter experts)
  • PR was reviewed and approved by a member of the Sentry docs team

EXTRA RESOURCES

@vercel

vercel Bot commented Jul 30, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
sentry-docs Ready Ready Preview Jul 31, 2026 9:39pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Jul 31, 2026 9:39pm

Request Review

@cursor cursor Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Cursor Bugbot has reviewed your changes and found 1 potential issue.

Fix All in Cursor

❌ Bugbot Autofix is OFF. To automatically fix reported issues with cloud agents, enable autofix in the Cursor dashboard.

Want reviews to match your repository better? Bugbot Learning can learn team-specific rules from PR activity. A team admin can enable Learning in the Cursor dashboard.

Reviewed by Cursor Bugbot for commit 84b5144. Configure here.

![Configuration options for defining ownership rules from an issue page.](./img/issue_details_edit_ownership_rules.png)

When you create a rule from the **Issue Details** page, you'll see some suggested paths and URLs based on the events in the issue. Note that [sentry.io](https://sentry.io) doesn't suggest tags.
When you create a rule from an **Issue Details** page, you'll see some suggested paths and URLs based on the events in the issue. Note that [sentry.io](https://sentry.io) doesn't suggest tags.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Orphaned ownership rules screenshot

Low Severity

The reference to issue_details_edit_ownership_rules.png was removed, but the image file still remains under img/. Other removed screenshots appear to have been deleted, so this leftover asset looks unused and adds avoidable clutter.

Fix in Cursor Fix in Web

Reviewed by Cursor Bugbot for commit 84b5144. Configure here.

- Fix factual error: CODEOWNERS exclusion rules are now supported
- Fix UI references: assignee selector is now in header, not sidebar cog
- Fix auto-assignment: document all 3 options (suspect commits, issue owner, off)
- Improve page structure with clearer hierarchy and table for rule types
- Add rule syntax examples with code block
- Add dedicated Permissions section
- Streamline Code Owners section with setup steps
- Expand troubleshooting with common issues (rules not matching, auto-assignment not working, code owners not matching)
Comment on lines 140 to 146
path:backend/endpoints/auth/* #auth-team #enterprise-team
```

For this event, we:

1. Evaluate against the code owners top-to-bottom; we get three matches.
2. Evaluate against the ownership rules top-to-bottom; we get two matches.

The matches, in order, are:
Sentry evaluates the code owners top-to-bottom first, then ownership rules top-to-bottom. The matches, in order, are:

```
[

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Bug: The documentation incorrectly states that Sentry supports CODEOWNERS exclusion rules. The product actually ignores these rules, leading to silent failures in ownership assignment.
Severity: MEDIUM

Suggested Fix

Revert the documentation change to reflect the actual product behavior. The documentation should state that Sentry does not support exclusion rules (lines without owners) in CODEOWNERS files and that such lines are ignored.

Prompt for AI Agent
Review the code at the location below. A potential bug has been identified by an AI
agent. Verify if this is a real issue. If it is, propose a fix; if not, explain why it's
not valid.

Location: docs/product/issues/ownership-rules/index.mdx#L140-L146

Potential issue: The documentation is being updated to claim that Sentry supports GitHub
`CODEOWNERS` file syntax, including exclusion rules (lines without owners). However,
evidence indicates that Sentry does not support this feature and silently ignores lines
in `CODEOWNERS` files that do not have an owner. Users who rely on this updated
documentation will find that their exclusion rules do not work as expected, leading to
incorrect issue ownership assignment without any warning or error.

Did we get this right? 👍 / 👎 to inform future reviews.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Stale content. This behavior was updated in May.

@sfanahata sfanahata left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Added a few more updates to the latest content related to ownership rules and refactored the page.

@sfanahata
sfanahata merged commit c1c4d08 into master Jul 31, 2026
22 checks passed
@sfanahata
sfanahata deleted the smi/chore/stale-image-18214 branch July 31, 2026 21:51
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Update stale images: product/issues/ownership-rules (9 screenshots)

2 participants