Open Issues Need Help
View All on GitHubAI Summary: This issue proposes adding a new adapter for Cloudflare Pages to the `DeployTargetAdapter` interface. The goal is to enable deployment to Cloudflare Pages by emitting the necessary configuration files like `wrangler.toml` and potentially `_routes.json`. The scope is limited to medium depth, avoiding complex API calls or token management, and focusing on common SSG frameworks.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes adding a Netlify adapter to the project, implementing the `DeployTargetAdapter` interface. The adapter will generate a `netlify.toml` file for common SSGs and provide a CLI command for deployment, without requiring complex Netlify API interactions.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes automating the merging of Dependabot pull requests for safe dependency updates. It aims to automatically merge patch-only bumps that don't introduce API changes and pass all tests, while requiring manual review for minor or major version bumps. A new GitHub Actions workflow will be implemented to manage this automation.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes adding hyperlinks to three specific how-to guides to improve their usefulness and discoverability. The solution involves incorporating internal and external links to related documentation, tutorials, resources, and example code. The goal is to ensure each guide has 3-5 contextually appropriate, working hyperlinks.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes adding hyperlinks to several how-to guides to improve their usefulness and discoverability. The solution involves adding 3-5 contextually appropriate internal and external links to each affected file, ensuring they pass a link checker and adhere to conventional commit standards.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue addresses broken links in the project's documentation. The URL `https://github.com/tosin2013/documcp/issues` is returning 406 errors and needs to be replaced with a functional URL for either creating new issues or browsing existing ones. The fix involves updating five specific files within the documentation directory.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue addresses broken links within the project's documentation. The URL `https://github.com/tosin2013/documcp/issues` is no longer valid and needs to be replaced with either a link to create new issues or a link to browse existing ones across five specified markdown files. The fix is estimated to take 15 minutes and is labeled as a 'good first issue'.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes to modify the CI pipeline to skip commitlint validation for specific 'Initial plan' bootstrap commits generated by the Copilot Coding Agent. This is necessary because these commits have a non-conventional format that incorrectly triggers commitlint errors, blocking future Copilot-related PRs. The goal is to ignore these specific commits without compromising the validation of human-authored commits.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue requests the addition of Astro as a supported Static Site Generator (SSG) within a project. It involves implementing detection logic, generating a configuration file, and creating a deployment workflow template specifically for Astro projects. The goal is to enable seamless integration and deployment of Astro sites.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes adding a new SSG adapter for VitePress to the project. The goal is to mirror the functionality of the existing Astro adapter (C3), enabling detection of VitePress projects, generating necessary configuration files, and creating a deployment workflow for platforms like GitHub Pages. This will enhance support for Vue and TypeScript-heavy projects.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes defining a new `DeployTargetAdapter` interface to support various deployment targets beyond GitHub Pages. It also includes the implementation of the Vercel adapter as the first non-GitHub Pages target, along with necessary registry updates and tests. This work is foundational for future integrations with Netlify and Cloudflare Pages.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes adding a standalone command-line interface (CLI) mode to the documcp package. This will allow users to run commands like `documcp analyze`, `documcp recommend`, and `documcp deploy` directly on their repositories without needing to run an MCP server. The CLI will reuse existing tool handlers to avoid code duplication.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes creating a GitHub App to integrate DocuMCP's drift detection into the repository workflow. The app will trigger on push and pull request events, comment on PRs with drift findings categorized by severity, and open issues for significant drift on the default branch, leveraging an existing snapshot system.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes the creation of a VS Code extension to integrate DocuMCP tools into the IDE. The extension will expose key DocuMCP functionalities as commands and a sidebar view, communicating with a local DocuMCP server via standard input/output. The goal is to improve developer experience by making these tools readily accessible within VS Code.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes adding a new Docker Compose recipe for a "demo mode" to simplify trying out the DocuMCP tool. This mode will automatically set up a sample repository, run analysis and recommendation commands, and serve the generated Docusaurus site, significantly lowering the barrier to entry for evaluation.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes to significantly restructure the `CONTRIBUTING.md` file to be more user-friendly. It aims to create role-based contribution paths, guiding users on how to contribute based on their interests (e.g., fixing bugs, adding adapters, writing docs). Each path will include links to relevant examples and issue labels.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue requires a documentation quality audit using specific validation scripts against the `docs/` directory. The goal is to identify areas falling below an 85% quality bar and create follow-up issues for each category needing improvement. The audit report will be committed to a specific markdown file, and link checks must also pass.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes expanding the existing performance benchmark suite to handle larger, more complex repositories. The goal is to create new benchmark fixtures for repositories with 100, 1k, and 5k files, and to integrate these benchmarks into the CI pipeline. The results will be published as artifacts and a summary in PR comments, including regression detection.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes building a static HTML dashboard within a Docusaurus site to display key release metrics like install success rate, time-to-publish, coverage trend, and CI flake rate. The data will be pulled from GitHub API and the npm registry, refreshed nightly via a GitHub Action, and rendered as pre-rendered SVGs or static JSON with a charting library.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
AI Summary: This issue proposes creating a deterministic script to generate enhanced release notes from conventional commit metadata. The script will group commits by type, link to related ADRs and PRs, display test coverage deltas, and summarize dependency bumps, all without using an LLM. It needs to be integrated into the existing release workflow.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.
DocuMCP is an intelligent Model Context Protocol (MCP) server that revolutionizes documentation deployment for open-source projects. It provides deep repository analysis, intelligent static site generator recommendations, and automated GitHub Pages deployment workflows.