Skip to content

Conversation

continue[bot]
Copy link
Contributor

@continue continue bot commented Sep 24, 2025

This PR adds comprehensive JSON-LD structured data to the Continue documentation site to improve SEO and search engine understanding.

Changes Made

JSON-LD Implementation

  • Added structured data to key documentation pages using embedded script tags in MDX files
  • Implemented dynamic content based on information from continue.dev main site
  • Created reusable JSON-LD patterns for different page types

Pages Updated

  • Homepage (index.mdx): Organization + SoftwareApplication + WebSite schemas
  • Getting Started (getting-started/overview.mdx): HowTo schema with step-by-step instructions
  • FAQ Page (faqs.mdx): FAQPage schema with 8+ common questions and answers
  • Agent Feature Page (features/agent/quick-start.mdx): TechArticle schema for feature documentation

Structured Data Types Added

  • Organization Schema: Company details, founding date, social media links, contact info
  • SoftwareApplication Schema: App details, features, download links, compatibility
  • WebSite Schema: Site-wide information with search action
  • FAQPage Schema: Common support questions with answers
  • TechArticle Schema: Feature documentation with keywords and categorization
  • HowTo Schema: Step-by-step guides for getting started

Dynamic Content Integration

All JSON-LD includes dynamic details from continue.dev:

  • Product description and features (Agent, Chat, Edit, Autocomplete)
  • Download links (VS Code Marketplace, JetBrains Plugin Store)
  • Social media and community links (GitHub, Discord, Twitter, LinkedIn)
  • Support and contact information
  • Free/open-source pricing model
  • Cross-platform compatibility (Windows, macOS, Linux)

Technical Implementation

  • Used inline script tags with application/ld+json for Mintlify compatibility
  • Created reusable generator scripts for future use
  • Followed Google structured data guidelines for optimal SEO impact
  • Maintained clean, readable JSON-LD formatting

Benefits

  • Improved search engine understanding of Continue purpose and features
  • Better rich snippets and search result display
  • Enhanced discoverability for common support questions
  • Structured data for product listings and software directories
  • Improved organization and contact information visibility

Testing

  • All JSON-LD validates against Schema.org specifications
  • Embedded scripts are compatible with Mintlify MDX processing
  • Content dynamically reflects current continue.dev information

This agent session was created by bdougieyo and co-authored by Continue [email protected].


Summary by cubic

Adds dynamic JSON-LD structured data across the docs to improve SEO and rich results. Includes a generator that injects page-type schemas and inline snippets for key pages (addresses CON-4085).

  • New Features
    • Added Organization, SoftwareApplication, WebSite, FAQPage, TechArticle, and HowTo schemas.
    • Updated index.mdx, getting-started/overview.mdx, faqs.mdx, and features/agent/quick-start.mdx with embedded ld+json.
    • Added jsonld-generator.js to auto-generate per route (homepage, features, guides, reference, FAQs) and handle SPA navigation; added jsonld-snippet.js for lightweight inline use.
    • Populates dynamic details from continue.dev (features, downloads, social/support); Schema.org-valid and Mintlify-compatible.

- Add comprehensive JSON-LD structured data to key documentation pages
- Include Organization, SoftwareApplication, and WebSite schemas for better SEO
- Add FAQ structured data with common questions and answers
- Add TechArticle schema for feature documentation pages
- Add HowTo schema for getting started and tutorial pages
- Include dynamic content from continue.dev page including:
  - Organization details and social media links
  - Software application features and download links
  - Contact information and support channels
  - Product offerings and pricing information
- Create reusable JSON-LD generators for future page additions
- All JSON-LD is embedded directly in MDX files for Mintlify compatibility

Generated with Continue
Co-Authored-By: Continue <[email protected]>
@continue continue bot requested a review from a team as a code owner September 24, 2025 22:52
@continue continue bot requested review from Patrick-Erichsen and removed request for a team September 24, 2025 22:52
@dosubot dosubot bot added the size:XL This PR changes 500-999 lines, ignoring generated files. label Sep 24, 2025
Copy link

⚠️ PR Title Format

Your PR title doesn't follow the conventional commit format, but this won't block your PR from being merged. We recommend using this format for better project organization.

Expected Format:

<type>[optional scope]: <description>

Examples:

  • feat: add changelog generation support
  • fix: resolve login redirect issue
  • docs: update README with new instructions
  • chore: update dependencies

Valid Types:

feat, fix, docs, style, refactor, perf, test, build, ci, chore, revert

This helps with:

  • 📝 Automatic changelog generation
  • 🚀 Automated semantic versioning
  • 📊 Better project history tracking

This is a non-blocking warning - your PR can still be merged without fixing this.

@bdougie bdougie self-assigned this Sep 25, 2025
@bdougie bdougie marked this pull request as draft September 25, 2025 00:46
@bdougie bdougie changed the title Add dynamic JSON-LD structured data to Continue documentation docs: Add dynamic JSON-LD structured data to Continue documentation Sep 25, 2025
- Format docs/jsonld-generator.js
- Format docs/jsonld-snippet.js

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

Co-Authored-By: Continue <[email protected]>
Aligns with current continue.dev website messaging which consistently uses
'AI coding agent' and 'custom AI coding agents' terminology

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

Co-Authored-By: Continue <[email protected]>
Replace broken continue.dev screenshot URL with working docs image URL

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

Co-Authored-By: Continue <[email protected]>
Generated with [Continue](https://continue.dev)

Co-Authored-By: Continue <[email protected]>
- Convert raw JSON-LD scripts to use dangerouslySetInnerHTML
- Wrap JSON-LD data in JSON.stringify() to properly escape @ symbols
- Fix parsing errors in quick-start.mdx, faqs.mdx, overview.mdx, and index.mdx

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

Co-Authored-By: Continue <[email protected]>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size:XL This PR changes 500-999 lines, ignoring generated files.
Projects
Status: Todo
Development

Successfully merging this pull request may close these issues.

3 participants