Skip to content

docs(issues): add Inbox and issue progress states page - #19103

Merged
souredoutlook merged 5 commits into
masterfrom
nmeisenheimer/docs/issue-inbox
Aug 26, 2026
Merged

docs(issues): add Inbox and issue progress states page#19103
souredoutlook merged 5 commits into
masterfrom
nmeisenheimer/docs/issue-inbox

Conversation

@souredoutlook

@souredoutlook souredoutlook commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

DESCRIBE YOUR PR

Adds documentation for the experimental Inbox page under Issues, plus a reference section for the issue.progress states that drive it.

  • New page at docs/product/issues/inbox/ covering what the Inbox shows (two-pane layout, category filtering), the progress sections and issue cards, and the two page controls (assignee filter, resize handle)
  • Documents the preview pane: header, Seer/Autofix actions, priority and assignee, linked PRs, Autofix summary, and activity
  • Adds an "Issue Progress States" section explaining the five-state ladder (identifiedassigneddiagnosedfix_proposedfix_applied), how progress advances and falls back, close/reopen behavior, Autofix edge cases, and searching with issue.progress
  • Links the Inbox from the Issues overview page

Flagged as experimental and Seer-gated at the top of the page, matching the feature's current rollout state.

IS YOUR CHANGE URGENT?

Help us prioritize incoming PRs by letting us know when the change needs to go live.
Select exactly one option. For deadlines, replace YYYY-MM-DD with the due date. You can update this information later by editing the PR description.

  • Urgent deadline (GA date, etc.): YYYY-MM-DD
  • Other deadline: 2026-08-28
  • No deadline: 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 supplied a deadline.

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

Documents the experimental Inbox under Issues: the two-pane layout,
progress sections, assignee filter, resize handle, and preview pane.
Adds a subsection covering the five issue.progress states, how progress
advances and falls back, Autofix interaction, and searching by progress.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@vercel

vercel Bot commented Aug 24, 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 Aug 26, 2026 8:25pm
1 Skipped Deployment
Project Deployment Actions Updated (UTC)
develop-docs Ignored Ignored Preview Aug 26, 2026 8:25pm

Request Review

@codeowner-assignment
codeowner-assignment Bot requested a review from a team August 24, 2026 20:15
@souredoutlook
souredoutlook marked this pull request as draft August 24, 2026 20:18
@github-actions github-actions Bot added the Priority: Normal Docs review has no urgent deadline label Aug 24, 2026
Restructures the Inbox page around what the view shows and how progress
changes, drops the searchable-properties section, and uses code style
consistently for the five progress state names.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Frames progress as a derived description rather than a mutable state,
confines Identified to a single explanatory paragraph, and redefines
Assigned to cover issues suggested for you or your teams.

Also fixes comma splices and typos, and replaces em dashes with colons
in the preview pane list.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@souredoutlook
souredoutlook enabled auto-merge (squash) August 26, 2026 18:12
Comment thread docs/product/issues/inbox/index.mdx
@sfanahata
sfanahata self-requested a review August 26, 2026 18:19
@github-actions github-actions Bot added Priority: Deadline Docs review has a specific non-urgent due date and removed Priority: Normal Docs review has no urgent deadline labels Aug 26, 2026
Comment thread docs/product/issues/inbox/index.mdx

Learn more about triaging issues and their different states in [Issue States and Triage](/product/issues/states-triage/).

If your organization has Seer, the [**Inbox**](/product/issues/inbox/) offers a different way to triage: it groups the issues assigned to you by how close they are to being fixed, so you can start with the ones that need the least work to finish.

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.

I'm bristling at this a little, and I think it's because it feels like this sentence is leaving out whether or not that issue is also valuable to fix. is that something that goes into consideration at all?

@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.

@souredoutlook I made a bunch of updates. I think this doc is in good shape now, but we need to revisit the whole concept once Inbox starts branching out to being more of a priority/triaging list vs Seer focused.

@souredoutlook
souredoutlook merged commit 663c833 into master Aug 26, 2026
22 checks passed
@souredoutlook
souredoutlook deleted the nmeisenheimer/docs/issue-inbox branch August 26, 2026 20:30
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Priority: Deadline Docs review has a specific non-urgent due date

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants