Skip to content

Conversation

bdougie
Copy link
Collaborator

@bdougie bdougie commented Oct 3, 2025

Description

This PR adds a comprehensive Continue Docs MCP cookbook that demonstrates how to use the Continue Docs MCP to contribute documentation, create cookbooks, and maintain consistency across Continue's docs through natural language prompts.

Key Changes:

  • New cookbook: - Complete guide showing how to use the Continue Docs MCP for documentation workflows
  • Navigation updates: Updated to include the new cookbook in the navigation
  • Overview integration: Added link to the new cookbook in within the MCP Integration Cookbooks section

The cookbook covers:

  • Setting up the Continue Docs MCP (with quick start using the pre-built agent)
  • Creating new cookbooks with AI assistance
  • Updating existing documentation
  • Adding new guides
  • Real-world examples for PostgreSQL, Sentry, and OpenAPI cookbooks
  • Advanced prompt patterns for multi-source research
  • Testing and validation workflows
  • Automated documentation checks

AI Code Review

  • Team members only: AI review runs automatically when PR is opened or marked ready for review
  • Team members can also trigger a review by commenting @continue-review

Checklist

  • I've read the contributing guide
  • The relevant docs, if any, have been updated or created
  • The relevant tests, if any, have been updated or created

Screen recording or screenshot

The cookbook includes extensive examples and can be previewed locally using npm run dev in the docs directory. It follows the same structure and formatting as existing cookbooks like the dlt and Sanity MCP cookbooks.

Tests

https://continue-docs-bdougie-continue-docs-mcp-cookbook.mintlify.app/

  • Verified all Mintlify components render correctly
  • Confirmed all internal links point to existing documentation
  • Tested cookbook structure follows established patterns
  • Validated navigation updates work correctly in local preview

Summary by cubic

Adds a new Continue Docs MCP cookbook and updates navigation to make it easy to find. This helps contributors write and maintain docs with consistent patterns and workflows.

  • New Features
    • Added Continue Docs MCP Cookbook (docs/guides/continue-docs-mcp-cookbook.mdx) with setup, workflows, real-world examples, advanced prompts, testing, and a GitHub Actions docs-check example.
    • Updated docs.json to include the new cookbook under Cookbooks and added the Sanity cookbook entry.
    • Updated guides/overview.mdx to feature the new cookbook and link to dlt and Sanity cookbooks.

bdougie and others added 3 commits October 2, 2025 22:48
- Add comprehensive Continue Docs MCP cookbook guide
- Update docs.json navigation with new cookbook entries
- Add dlt and Sanity MCP cookbook links to overview
- Include GitHub Actions workflow for documentation checks
- Add Sentry error analysis utility scripts

This cookbook demonstrates how to use the Continue Docs MCP to:
- Research existing documentation patterns
- Create new cookbooks with AI assistance
- Maintain consistency across documentation
- Automate documentation quality checks

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <noreply@continue.dev>
- Remove analyze-sentry-errors.js (Sentry analysis utility)
- Remove docs/test-sentry-mcp.js (MCP test script)
- Remove .github/workflows/docs-update-check.yml (docs automation workflow)

These files were not part of the core documentation changes and
should be handled separately from the cookbook documentation.

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <noreply@continue.dev>
Add link to continue-docs-mcp-cookbook in the MCP Integration Cookbooks
section of the guides overview page. Places it at the top of the list
as it's the most relevant for contributors working on documentation.

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <noreply@continue.dev>
Remove references to guides/sanity-mcp-continue-cookbook from:
- docs/docs.json navigation
- docs/guides/overview.mdx MCP cookbooks section

The Sanity MCP cookbook is not yet available, so removing
the broken link to prevent 404 errors.

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <noreply@continue.dev>
@bdougie bdougie marked this pull request as ready for review October 3, 2025 05:58
@bdougie bdougie requested a review from a team as a code owner October 3, 2025 05:58
@bdougie bdougie requested review from sestinj and removed request for a team October 3, 2025 05:58
@dosubot dosubot bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Oct 3, 2025
@bdougie bdougie requested a review from BekahHW October 3, 2025 05:58
Copy link

github-actions bot commented Oct 3, 2025

✅ Review Complete

⚠️ AI review completed but no review output was generated.

Likely cause: Expired CONTINUE_API_KEY or missing continuedev/review-bot assistant

📋 View workflow logs for details.


Copy link
Contributor

@cubic-dev-ai cubic-dev-ai bot left a comment

Choose a reason for hiding this comment

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

2 issues found across 3 files

Prompt for AI agents (all 2 issues)

Understand the root cause of the following 2 issues and fix them.


<file name="docs/guides/overview.mdx">

<violation number="1" location="docs/guides/overview.mdx:27">
This new navigation entry links to /guides/sanity-mcp-continue-cookbook, but there is no corresponding guide file, so users will hit a 404. Please add the missing guide or remove/replace the link.</violation>
</file>

<file name="docs/guides/continue-docs-mcp-cookbook.mdx">

<violation number="1" location="docs/guides/continue-docs-mcp-cookbook.mdx:377">
Hard-coding `origin/main` here breaks the workflow for PRs targeting any other base branch; use the PR’s actual base ref instead.</violation>
</file>

React with 👍 or 👎 to teach cubic. Mention @cubic-dev-ai to give feedback, ask questions, or re-run the review.

BekahHW
BekahHW previously approved these changes Oct 3, 2025
@github-project-automation github-project-automation bot moved this from Todo to In Progress in Issues and PRs Oct 3, 2025
@dosubot dosubot bot added the lgtm This PR has been approved by a maintainer label Oct 3, 2025
@BekahHW
Copy link
Collaborator

BekahHW commented Oct 3, 2025

This looks great. Seems like there are some broken links, but otherwise looks good to go.

@bdougie
Copy link
Collaborator Author

bdougie commented Oct 3, 2025

This looks great. Seems like there are some broken links, but otherwise looks good to go.

I worked on it in the same session build the Sanity one. I merge and hopefully get the sanity one in today too.

Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <noreply@continue.dev>
@BekahHW BekahHW merged commit 281d89f into main Oct 3, 2025
54 of 57 checks passed
@BekahHW BekahHW deleted the bdougie/continue-docs-mcp-cookbook branch October 3, 2025 14:09
@github-project-automation github-project-automation bot moved this from In Progress to Done in Issues and PRs Oct 3, 2025
@github-actions github-actions bot locked and limited conversation to collaborators Oct 3, 2025
@sestinj
Copy link
Contributor

sestinj commented Oct 5, 2025

🎉 This PR is included in version 1.22.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@sestinj
Copy link
Contributor

sestinj commented Oct 6, 2025

🎉 This PR is included in version 1.26.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

@sestinj
Copy link
Contributor

sestinj commented Oct 15, 2025

🎉 This PR is included in version 1.2.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

lgtm This PR has been approved by a maintainer released size:XL This PR changes 500-999 lines, ignoring generated files.

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants