Skip to content

docs: polish README for PyCon#31

Merged
beonde merged 2 commits into
mainfrom
docs/readme-pycon-polish
May 13, 2026
Merged

docs: polish README for PyCon#31
beonde merged 2 commits into
mainfrom
docs/readme-pycon-polish

Conversation

@beonde
Copy link
Copy Markdown
Member

@beonde beonde commented May 12, 2026

DX improvements for PyCon readiness:

  • Title: 'CapiscIO MCP Guard' → 'MCP Guard' (matches capisc.io/products/mcp-guard)
  • Add explicit package name in intro: 'MCP Guard (pip install capiscio-mcp)'
  • Replace unsafe code examples (raw open(path), os.listdir(directory)) with safe DB examples — bad optics for a security product README
  • Add quickstart navigation guide ('Building an MCP server? Start with Quickstart 1')
  • Add Related Packages ecosystem section
  • Add docs/website/platform links

Copilot AI review requested due to automatic review settings May 12, 2026 05:57
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull request overview

This PR updates the project README to improve developer experience and messaging for “MCP Guard” ahead of PyCon, including clearer positioning, navigation to key quickstarts, safer-looking examples, and ecosystem links.

Changes:

  • Renames/rewrites the README header/intro and adds the explicit install command inline.
  • Adds a “Quickstarts” navigation section linking to the three quickstart areas.
  • Replaces filesystem-based example tools with database-oriented examples and adds a “Related Packages” section plus docs/website/platform links.

Comment thread README.md
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
- Replace raw SQL execute_query() with parameterized get_user()
- Bump list_tables to trust level 1, fix wording to avoid implying
  level 0 means authenticated
- Add db placeholder initialization comment
- Replace bare 'go install' with link to install guide
@beonde beonde merged commit f1e5daa into main May 13, 2026
8 checks passed
@beonde beonde deleted the docs/readme-pycon-polish branch May 13, 2026 14:00
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