Skip to content

ask agents to report wrong pages - #271

Merged
SyedFahad7 merged 1 commit into
mainfrom
docs/feedback-instructions
Nov 17, 2026
Merged

SyedFahad7 merged 1 commit into
mainfrom
docs/feedback-instructions

Conversation

@SyedFahad7

Copy link
Copy Markdown
Collaborator

Most of our docs traffic now comes from coding agents, but when one hits a wrong or outdated page we never hear about it. Our docs site already accepts page feedback at /feedback, so this adds one line to the agent instructions on every Markdown page telling agents how to report a docs problem there. It asks them to report docs issues only and never to send secrets, personal data or the user's code. Reports show up in the Mintlify feedback dashboard next to reader ratings.

Copilot AI balanced review requested due to automatic review settings November 17, 2026 01:11
@mintlify

mintlify Bot commented Nov 17, 2026 •

Copy link
Copy Markdown
Contributor

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

Project Status Preview Updated
graphify-labs-inc 🟢 Ready View Preview Nov 17, 2026, 1:11 AM

💡 Tip: Enable Automations to automatically generate PRs for you.

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Copilot was unable to review this pull request because the user who requested the review has insufficient remaining quota. Try requesting a review at a lower effort level.

An organization owner can choose the repository organization as the billing source for reviews requested by members with a paid Copilot license. Learn about Copilot code review billing.

@graphify-labs-staging graphify-labs-staging Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

Graphify code review View in Graphify

Reviewed · 6aef3bf6e7ec

Adds an instruction telling agents to report broken or missing docs by POSTing a minimal JSON payload to /feedback.

Full summary

Adds an instruction telling agents to report broken or missing docs by POSTing a minimal JSON payload to /feedback. The rule explicitly bars secrets, user code, or personal data and applies only to the listed pages. No other behavior or fallback changes.

No blocking issues surfaced.

Code graph and static checks · 93 functions depend on this change

Impact & health

Impact — 93 functions depend on the 93 functions this change touches.

Health — grade A; no new coupling hotspots.

Formal checks — 93 functions this change can affect weren't formally checked in this review. Formal checks are informational only.

Health delta baseline: last indexed commit 445ead8 (diverged from this PR's base — delta is approximate).

Gate & verification

✅ PASS — objectively clean (no health regressions, tests not run — proofs not run this pass (advisory)). Grounded, not self-assessed.

Advisory (not blocking):

  • verification_scope: 93 function(s) in the blast radius were not formally verified this run

@SyedFahad7
SyedFahad7 merged commit b9050b6 into main Nov 17, 2026
3 checks passed

This branch was successfully deployed

1 active deployment
staging — 6aef3bf6 Deployed Nov 17, 2026 by mintlify[bot]
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.

2 participants