[DOCSW-685] docs: restructure Plane AI page to reflect embedding model is optional

[cursor]

Summary

Restructured the Plane AI configuration documentation to clarify that configuring the embedding model is now optional. Plane AI chat, duplicate detection, and other LLM-powered features work without OpenSearch or an embedding model — semantic search is the only feature that requires embeddings.

Changes

Documentation Updates

• Frontmatter: Updated description to emphasize that embedding models are optional
• Introduction: Clarified that semantic search is optional while other AI features work without embeddings
• Before you begin: Moved OpenSearch and embedding model requirements to an optional section with clear explanation of what works without them
• Startup checks: Updated to clarify that embedding dimension checks only apply when OpenSearch is configured
• OpenSearch section: Renamed to "Configure OpenSearch and an embedding model (optional)" with clear guidance that this is optional
• Embedding model configuration: Added info box to clarify when this section can be skipped
• Vectorize existing data: Added info box indicating this is only needed for semantic search
• After setup: Split into two sections: what's available by default, and what's available if semantic search is configured
• Embedding models: Updated heading to clarify embeddings are optional

Key Message

The restructured page now clearly communicates:

• ✅ Plane AI chat works without embeddings
• ✅ Duplicate detection works without embeddings
• ✅ LLM-powered features work without embeddings
• ⚠️ Semantic search requires OpenSearch + embedding model configuration

Testing

• Documentation builds successfully
• All sections maintain logical flow
• Optional sections are clearly marked
• Required vs optional requirements are distinct

Related

Closes DOCSW-685

  

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
developer-docs	Ready	Preview, Comment	May 14, 2026 0:56am

[makeplane]

Linked to Plane Work Item(s)

• [DOCSW-685] Embedding model is optional

This comment was auto-generated by Plane