Official documentation and user guide for WonkaChat - the AI-powered collaboration platform.
This repository contains the complete documentation site built with Mintlify, covering everything users need to know about using WonkaChat effectively.
The documentation is organized into the following sections:
- Welcome - Introduction, quick start, and why WonkaChat
- AI Agents - Creating, finding, using, and teaching agents
- Tools Connection - MCP setup and tool integration
- Improved Usage - Best practices, prompt engineering, and prompt library
- Security & Governance - Security overview, access control, best practices, and compliance
- Support & Resources - Troubleshooting, FAQs, and getting help
- Learning - Foundations of AI agents and MCP concepts
- Use Cases - Practical examples and applications
- Updates - Changelog and version history
- Roadmap - Upcoming features and development plans
Install the Mintlify CLI to preview documentation changes locally:
npm i -g mintRun the following command at the root of the documentation (where docs.json is located):
mint devView your local preview at http://localhost:3000
.
βββ docs.json # Navigation and site configuration
βββ welcome/ # Getting started pages
βββ ai-agents/ # AI agent documentation
βββ tools-connection/ # MCP and tool integration
βββ improved-usage/ # Usage best practices
βββ security-governance/ # Security and compliance
βββ support-resources/ # Help and troubleshooting
βββ learn/ # Educational content
βββ use/ # Use cases
βββ updates/ # Changelog
βββ roadmap/ # Future development
βββ images/ # Documentation images
This documentation follows Mintlify technical writing best practices:
- Use clear, direct language appropriate for technical audiences
- Write in second person ("you") for instructions
- Lead with the most important information
- Break complex procedures into numbered steps
- Include code examples and screenshots where helpful
- Use Mintlify components (Cards, Accordions, Tabs, etc.) for better organization
Common components used throughout:
<Steps>- Sequential instructions<Tabs>- Alternative content or platform-specific info<Accordion>- Collapsible detailed information<Card>/<CardGroup>- Visual navigation and highlights<Frame>- Image containers with captions<Info>/<Tip>/<Warning>/<Check>- Callout boxes<CodeGroup>- Multi-language code examples
Every documentation page must include:
- YAML frontmatter with title and description
- Clear headings following logical hierarchy
- Practical examples that users can follow
- Visual aids (screenshots, diagrams) where appropriate
- No placeholder content - all information must be accurate and verified
Install the Mintlify GitHub app from your dashboard to automatically deploy changes. Updates to the default branch are deployed to production automatically.
Before committing:
- Test locally with
mint dev - Check for broken links and images
- Verify all code examples work
- Ensure screenshots are up-to-date
- Review for spelling and grammar
- Dev environment not running: Run
mint updateto get the latest CLI version - Page loads as 404: Ensure you're running in a folder with a valid
docs.json - Images not loading: Check that image paths are correct and files exist in
/images/ - Navigation issues: Verify all pages referenced in
docs.jsonexist
When contributing to the documentation:
- Create a new branch for your changes
- Test locally before committing
- Use descriptive commit messages
- Follow the established writing style
- Ensure all information is accurate and current
See LICENSE file for details.
Built with Mintlify π