Skip to content

Migrate documentation to Mintlify - #4786

Open
trev-org wants to merge 2 commits into
vespa-engine:masterfrom
trev-org:mintlify-migration
Open

Migrate documentation to Mintlify#4786
trev-org wants to merge 2 commits into
vespa-engine:masterfrom
trev-org:mintlify-migration

Conversation

@trev-org

@trev-org trev-org commented Jul 1, 2026

Copy link
Copy Markdown

Migrate documentation to Mintlify

This PR migrates the Vespa documentation site from the current Jekyll setup to Mintlify.

What changed

  • Adds docs.json (navigation + site config), index.mdx landing page, and custom.css.
  • Converts the en/ and ja/ content from Jekyll HTML/Markdown to MDX.
  • Adds assets/, logo/, and favicon.png.
  • Removes the Jekyll build infrastructure (_config.yml, _layouts, _includes, _plugins, Gemfile, feed/generation scripts, etc.) that Mintlify replaces.
  • Keeps the existing README.md.

Preview

Live Mintlify preview: https://github.com/mintlify-onboarding/vespa-preview

Notes

Opened as a draft for review. This is a large diff by nature (full platform migration); happy to break it into smaller pieces or adjust scope based on maintainer preference.

trev-org and others added 2 commits July 1, 2026 14:04
Replaces the Jekyll-based site with a Mintlify docs setup:
- docs.json navigation/config, index.mdx landing page, custom.css
- Converts en/ and ja/ content to MDX
- Adds assets, logo, and favicon

Generated from the Mintlify preview at mintlify-onboarding/vespa-preview.
Bring the migration PR in line with mintlify-onboarding/vespa-preview@7de97353.

Co-authored-by: Cursor <cursoragent@cursor.com>
@trev-org
trev-org marked this pull request as ready for review July 13, 2026 16:22
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