Skip to content

docs: add CONTRIBUTING.md, split issue templates, update PR checklist#127

Open
mattpodwysocki wants to merge 10 commits intomainfrom
docs/contributor-infrastructure
Open

docs: add CONTRIBUTING.md, split issue templates, update PR checklist#127
mattpodwysocki wants to merge 10 commits intomainfrom
docs/contributor-infrastructure

Conversation

@mattpodwysocki
Copy link
Contributor

Description

Adds contributor infrastructure that was missing from the repo:

  • CONTRIBUTING.md: Root-level entry point for contributors. Points to docs/engineering_standards.md, CLAUDE.md, and AGENTS.md; includes quick-start, plop tool creation, changelog format, and security notes.
  • bug_report.yaml / feature_request.yaml: Replaces the single generic issue template with two structured YAML templates (bug report with MCP client dropdown, feature request with type selector).
  • pull_request_template.md: Adds CHANGELOG.md updated under Unreleased to the checklist.
  • README.md: Updates Contributing section to point to the new CONTRIBUTING.md as the primary entry point.

Testing

No code changes — documentation and GitHub config only. Verified file contents and links are consistent.


Checklist

  • Tests added or updated (npm test passes) — N/A (docs only)
  • Lint passes (npm run lint) — N/A (docs only)
  • CHANGELOG.md updated under Unreleased — N/A (docs only)
  • Documentation updated if needed (README, JSDoc) — yes, README updated

Additional Notes

These files were already present in mcp-docs-server-private (the public-facing companion repo) and are being mirrored here for consistency.

mattpodwysocki and others added 10 commits January 12, 2026 16:18
Implements MCP server icons at the correct architectural level (server
initialization) instead of at the tool level. Adds both light and dark
theme variants of the Mapbox logo using base64-encoded SVG data URIs.

- Add mapbox-logo-black.svg for light theme backgrounds
- Add mapbox-logo-white.svg for dark theme backgrounds
- Update server initialization to include icons array with theme property
- Use 800x180 SVG logos embedded as base64 data URIs

This replaces the previous incorrect approach of adding icons to
individual tools, which was not aligned with the MCP specification.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
Updates the MCP SDK from 1.25.1 to 1.25.2 and recreates the output
validation patch for the new version. The patch continues to convert
strict output schema validation errors to warnings, allowing tools
to gracefully handle schema mismatches.

Changes:
- Update @modelcontextprotocol/sdk from ^1.25.1 to ^1.25.2
- Recreate SDK patch for version 1.25.2
- Remove obsolete 1.25.1 patch file
- All 397 tests pass with new SDK version

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
@mattpodwysocki mattpodwysocki requested a review from a team as a code owner February 25, 2026 23:48
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.

1 participant