Skip to content

Enforce style guide: active voice and select terminology in MCP docs - #463

Open
mintlify[bot] wants to merge 2 commits into
mainfrom
style/mcp-voice-terminology
Open

mintlify[bot] wants to merge 2 commits into
mainfrom
style/mcp-voice-terminology

Conversation

@mintlify

@mintlify mintlify Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor

Summary

Small style fixes to the MCP setup and quickstart pages so they match the rest of the docs.

Changes

  • Rewrote the passive "the Bearer scheme is used for..." sentences in active voice and split them into two sentences (mcp/home, mcp/setup/other-clients, api-docs/in-depth-guides/mcp)
  • Changed "the Terminal49 tools are used" to second person, "you use the Terminal49 tools" (mcp/setup/agent-plugins)
  • Changed "choose/chose" to "select/selected" for UI actions to match the other setup guides (mcp/setup/antigravity, mcp/setup/gemini)

View with [code]smith Autofix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need.

@mintlify

mintlify Bot commented Oct 19, 2026 •

Copy link
Copy Markdown
Contributor Author

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

Project Status Preview Updated
terminal49 🟢 Ready View Preview Nov 9, 2026, 1:04 AM

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

@greptile-apps

greptile-apps Bot commented Oct 19, 2026

Copy link
Copy Markdown

PR author is in the excluded authors list.

@vercel

vercel Bot commented Oct 19, 2026 •

Copy link
Copy Markdown

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

Project Deployment Actions Updated
api Ready Ready Preview Nov 9, 2026 1:05am UTC

Request Review

@blacksmith-sh

blacksmith-sh Bot commented Oct 19, 2026

Copy link
Copy Markdown

Found 1 test failure on Blacksmith runners:

Failure

Test View Logs
agent trust guards: MCP registrations require supported literal tool names/
agent trust guards: MCP registrations require supported literal tool names
View Logs

Fix with [code]smith
Need help on this PR? Tag @codesmith-bot with what you need.

@github-actions github-actions Bot added risk:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission and removed risk:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission labels Oct 19, 2026
@github-actions github-actions Bot added risk:unknown Advisory evidence unavailable or changed; no merge permission and removed risk:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission labels Oct 28, 2026
@github-actions github-actions Bot added risk:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission and removed risk:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission labels Nov 2, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01V8cPhktNpguVMk39bAstza
@github-actions github-actions Bot added the risk-shadow:high Shadow-only risk signal: high label Nov 9, 2026
@github-actions

github-actions Bot commented Nov 9, 2026

Copy link
Copy Markdown
Contributor

Shadow risk calibration

Signal Result Authority
Path classifier risk:medium Deterministic advisory policy
heuristic fallback risk-shadow:high Shadow only

Calibration result: disagreement (medium vs high).

Shadow risk never blocks or enables merge. Keep it in observation mode until roughly 50 pull requests have human-reviewed labels, then calibrate before considering any policy use.

@github-actions github-actions Bot added risk:medium Advisory path risk; current-head human review needed risk:unknown Advisory evidence unavailable or changed; no merge permission and removed risk:unknown Advisory evidence unavailable or changed; no merge permission risk:medium Advisory path risk; current-head human review needed labels Nov 9, 2026

This branch was successfully deployed

2 active deployments
Preview — f0c444d3 Deployed Nov 9, 2026 by vercel[bot]
staging - docs — f0c444d3 Deployed Nov 9, 2026 by mintlify[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

risk:medium Advisory path risk; current-head human review needed risk-shadow:high Shadow-only risk signal: high

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant