{{ message }}
docs: clarify audience in "Why does MCP matter?" bullets - #3296
Merged
Conversation
The AI applications bullet mentioned the end-user experience and the end-users bullet described AI applications, so the two read as swapped (#3292). Reword both bullets to name their audience directly in every doc version that carried the identical text. Fixes #3292 Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ti1NPmKtsCq8aXah341HAp
|
Preview deployment for your docs. Learn more about Mintlify Previews. 💡 Tip: Enable Workflows to automatically generate PRs for you. |
github-actions
Bot
added
the
documentation
Per review feedback, describe the end-user benefit in third person instead of addressing the reader directly. Co-Authored-By: Claude <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01Ti1NPmKtsCq8aXah341HAp
localden
approved these changes
Aug 23, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Requested by Den Delimarsky · Slack thread
Fixes #3292.
Before: the last two bullets under "Why does MCP matter?" read as mismatched. The AI applications bullet talks about the end-user experience and the end-users bullet describes AI applications, which is what the issue reports.
After: each bullet now names its audience directly. The AI applications bullet says MCP gives them ecosystem access, and the end-users bullet says MCP results in more capable applications that can act on the user's behalf.
How: the literal swap proposed in the issue would leave the end-user phrasing under the AI applications heading with no referent, so the wording is adjusted in place instead, in every doc version that carried the identical text (2024-11-05, 2025-03-26, 2025-06-18, 2025-11-25, 2026-07-28, and draft). Per review feedback, the end-users bullet uses third person rather than addressing the reader. Verified with
npm run check:docsandnpm run format:docs, both clean.