Skip to content

docs(mcp): rewrite MCP server page with content guide standards#88

Merged
iamcxa merged 1 commit intomainfrom
docs/drc-2735-rewrite-mcp-server-page
Mar 10, 2026
Merged

docs(mcp): rewrite MCP server page with content guide standards#88
iamcxa merged 1 commit intomainfrom
docs/drc-2735-rewrite-mcp-server-page

Conversation

@iamcxa
Copy link
Contributor

@iamcxa iamcxa commented Mar 9, 2026

Summary

  • Apply recce-content-guide writing skill to rewrite the MCP server documentation page
  • Problem-first opening: leads with "dashboards break" instead of product description
  • Capitalize feature names per universal-terms.md (Schema Diff, Row Count Diff, Value Diff)
  • Prompt-style FAQ for better AISEO (AI discoverability)
  • Simplify base artifact instructions (remove git stash workflow)
  • De-emphasize "dbt" in page title per cloud-first strategy (universal-context.md)
  • Tighten prose throughout — remove filler phrases, make sections independently extractable

Relationship to PR #85

This PR is a companion to #85 (tools table accuracy fixes). PR #85 focused on technical accuracy; this PR applies content guide writing standards to the same page. If both merge, this PR's changes should be preferred for overlapping sections since it incorporates all review feedback from #85.

Test plan

  • mkdocs serve renders correctly with no broken links
  • Feature names match universal-terms.md capitalization
  • FAQ questions work as natural AI prompts
  • Page opens with problem statement per content guide

🤖 Generated with Claude Code

Apply recce-content-guide writing skill: problem-first opening,
capitalize feature names per universal-terms.md, prompt-style FAQ,
simplify base artifact instructions, de-emphasize dbt in title
per cloud-first strategy.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@iamcxa iamcxa requested a review from wcchang1115 March 9, 2026 07:16
Copy link
Contributor

@wcchang1115 wcchang1115 left a comment

Choose a reason for hiding this comment

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

LGTM, thanks!

@iamcxa iamcxa merged commit db82e48 into main Mar 10, 2026
@iamcxa iamcxa deleted the docs/drc-2735-rewrite-mcp-server-page branch March 10, 2026 00:50
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