Align feedback analytics docs with current dashboard

[mintlify]

Documentation changes

Updates the Feedback analytics docs to match Andrew's customer explanation (Slack #docs) and the current dashboard code (mintlify/mint apps/dashboard/components/analytics/v7/feedback/*, mintlify/server feedback.repository.ts).

Discrepancies fixed:

• optimize/feedback.mdx said the Feedback section shows a bar chart over time. It now has two cards: Page ratings (human thumbs only, by page) and Detailed feedback (comments, code snippet feedback, agent feedback). Added a note on filtering by time period and page/path.
• The "Filter by type" section listed Ratings by page / Detailed feedback / Code snippets. Replaced with the current controls: Page ratings sort (Most negative / Most positive) and Detailed feedback filters (Sentiment; Type: Comments, Agent feedback, Code blocks).
• Agent feedback was described as identified by an Agent badge in the list. Now points to the Type filter for isolating agent feedback, and notes that all other feedback is from humans.
• Explained that the Traffic view's Feedback total covers thumbs ratings, code snippet feedback, and agent feedback, and excludes assistant ratings.
• Thumbs ratings also count as actions in User engagements (cross-linked).
• analytics/assistant.mdx: clarified that Satisfaction is assistant response ratings, separate from page feedback.

Needs reviewer confirmation: the docs described setting feedback status (Pending / In Progress / Resolved / Dismissed), filtering by status, and adding internal notes. The current Feedback section only offers Dismiss. Dismissed items are hidden; there is no status picker, status filter, or notes UI (the old table is only kept for a few legacy subdomains). I replaced that section with "Dismiss feedback". If status or notes are coming back, revert that part.

Closes

---

For Reviewers

When reviewing documentation PRs, please consider:

✅ Technical accuracy

• Code examples work as written
• Commands and configurations are correct
• Links resolve to the right destinations
• Prerequisites and requirements are accurate

✅ Clarity and completeness

• Instructions are clear and easy to follow
• Steps are in logical order
• Nothing important is missing
• Examples help illustrate the concepts
• Content follows the style guide

✅ User experience

• A new user could follow these docs successfully
• Common gotchas or edge cases are addressed
• Error messages or troubleshooting guidance is helpful

---

Generated by Mintlify Agent.

Requested by: andrew@mintlify.com via Slack
Mintlify session: slack_1791264592.030339_C07M02Q0D6V

---

Note

Low Risk
Documentation-only changes with no runtime or security impact; reviewers should confirm the removal of status/notes matches product intent.

Overview
Updates Feedback and Assistant analytics docs so they match the current dashboard instead of the older bar-chart and status-workflow UI.

In optimize/feedback.mdx, the Feedback section is described as two cards—Page ratings (human thumbs by page) and Detailed feedback (comments, code blocks, agent feedback)—with time/page filters, sort and Sentiment/Type controls, and Dismiss instead of Pending/In Progress/Resolved and internal notes. It also clarifies what counts toward the Traffic Feedback total (including agent and snippet feedback, excluding assistant ratings) and links thumbs to User engagements.

In analytics/assistant.mdx, a Satisfaction bullet states assistant thumbs are separate from page feedback and do not affect Feedback totals.

^{Reviewed by Cursor Bugbot for commit 91162a3. Bugbot is set up for automated code reviews on this repo. Configure here.}

[mintlify]

Preview deployment for your docs. Learn more about Mintlify Previews.

Project	Status	Preview	Updated
mintlify	🟢 Ready	View Preview	Oct 6, 2026, 5:37 AM