Add FAQ page to Getting Started section

docs.json

@@ -25,7 +25,8 @@
               "quickstart",
               "installation",
               "editor",
-              "support"
+              "support",
+              "getting-started/faq"
             ]
           },
           {
@@ -97,7 +98,7 @@
               "api-playground/troubleshooting"
             ]
           },
-          { 
+          {
             "group": "Authentication and Personalization",
             "pages": [
               "settings/authentication-personalization/authentication",
@@ -155,7 +156,6 @@
                   "advanced/dashboard/sso",
                   "advanced/dashboard/permissions",
                   "advanced/dashboard/roles"
-
                 ]
               }
             ]
@@ -214,7 +214,7 @@
           {
             "group": "Version Control and CI/CD",
             "pages": [
-            "settings/github",
+              "settings/github",
               "settings/gitlab",
               "settings/ci",
               "settings/preview-deployments"

getting-started/faq.mdx

@@ -0,0 +1,198 @@
+---
+title: "Frequently Asked Questions"
+description: "Common questions and answers about Mintlify documentation platform"
+---
+
+# Frequently Asked Questions
+
+Find answers to the most commonly asked questions about Mintlify. If you can't find what you're looking for, feel free to reach out to our support team.
+
+## Getting Started
+
+<Accordion title="What is Mintlify?">
+  Mintlify is a modern documentation platform that helps developers create beautiful, interactive documentation websites. It transforms your markdown files into polished documentation sites with features like API references, interactive components, and seamless deployment.
+</Accordion>
+
+<Accordion title="How do I get started with Mintlify?">
+  Getting started is simple:
+  1. Install the Mintlify CLI: `npm i -g mintlify`
+  2. Initialize your project: `mintlify init`
+  3. Configure your `mint.json` file
+  4. Add your content in markdown files
+  5. Preview locally with `mintlify dev`
+  6. Deploy your documentation
+</Accordion>
+
+<Accordion title="Do I need coding experience to use Mintlify?">
+  While basic knowledge of markdown is helpful, you don't need extensive coding experience. Mintlify is designed to be developer-friendly while remaining accessible to technical writers and product managers who work with documentation.
+</Accordion>
+
+<Accordion title="Can I migrate my existing documentation to Mintlify?">
+  Yes! Mintlify supports migration from various documentation platforms. Most markdown-based documentation can be migrated with minimal changes. We provide migration guides for popular platforms like GitBook, Notion, and custom documentation sites.
+</Accordion>
+
+## Setup and Configuration
+
+<Accordion title="What files do I need to get started?">
+  The essential files for a Mintlify project are:
+  - `mint.json` - Configuration file for your documentation
+  - `introduction.mdx` - Your homepage content
+  - Additional `.mdx` or `.md` files for your documentation pages
+  - Optional: `favicon.svg`, custom CSS files, and images
+</Accordion>
+
+<Accordion title="How do I configure navigation in my documentation?">
+  Navigation is configured in the `mint.json` file using the `navigation` property. You can organize pages into groups, create nested navigation, and control the order of pages. Each navigation item should reference the path to your markdown files.
+</Accordion>
+
+<Accordion title="Can I customize the appearance of my documentation?">
+  Yes! Mintlify offers extensive customization options:
+  - Custom colors and branding in `mint.json`
+  - Custom CSS files
+  - Logo and favicon customization
+  - Font selections
+  - Light and dark mode themes
+</Accordion>
+
+<Accordion title="How do I add API documentation?">
+  Mintlify supports OpenAPI specifications for automatic API documentation generation. You can:
+  - Reference your OpenAPI spec in `mint.json`
+  - Use the `<OpenApi>` component in your markdown files
+  - Manually create API documentation using Mintlify's API components
+</Accordion>
+
+## Features and Functionality
+
+<Accordion title="What components are available in Mintlify?">
+  Mintlify provides a rich set of components including:
+  - `<Accordion>` for collapsible content
+  - `<Card>` and `<CardGroup>` for organized layouts
+  - `<Tabs>` for tabbed content
+  - `<CodeGroup>` for code examples
+  - `<Info>`, `<Warning>`, `<Tip>` callout boxes
+  - `<Frame>` for images and screenshots
+  - API components for endpoint documentation
+</Accordion>
+
+<Accordion title="Does Mintlify support code syntax highlighting?">
+  Yes! Mintlify supports syntax highlighting for over 100 programming languages. Simply specify the language in your code blocks, and Mintlify will automatically apply appropriate syntax highlighting.
+</Accordion>
+
+<Accordion title="Can I add interactive elements to my documentation?">
+  Absolutely! Mintlify supports:
+  - Interactive API playground
+  - Embedded videos and images
+  - Collapsible sections with Accordion
+  - Tabbed content organization
+  - Custom React components (on higher plans)
+</Accordion>
+
+<Accordion title="Is search functionality included?">
+  Yes, Mintlify includes built-in search functionality that indexes all your content automatically. Users can search through your documentation using the search bar, which supports fuzzy matching and instant results.
+</Accordion>
+
+## Deployment and Hosting
+
+<Accordion title="How do I deploy my Mintlify documentation?">
+  You can deploy your documentation in several ways:
+  - Connect your GitHub repository to Mintlify for automatic deployments
+  - Use the Mintlify CLI to deploy manually
+  - Deploy to your own hosting platform
+  - Use Mintlify's hosting service for hassle-free deployment
+</Accordion>
+
+<Accordion title="Can I use a custom domain?">
+  Yes! Mintlify supports custom domains. You can configure your custom domain in your project settings and update your DNS records to point to Mintlify's servers. SSL certificates are automatically provisioned.
+</Accordion>
+
+<Accordion title="Does Mintlify support authentication?">
+  Mintlify offers authentication features on paid plans, allowing you to:
+  - Protect your documentation with login requirements
+  - Integrate with SSO providers
+  - Control access to specific pages or sections
+  - Manage user permissions and groups
+</Accordion>
+
+## Pricing and Plans
+
+<Accordion title="Is Mintlify free to use?">
+  Mintlify offers a free tier that includes core documentation features, basic customization, and community support. Paid plans provide additional features like custom domains, authentication, analytics, and priority support.
+</Accordion>
+
+<Accordion title="What's the difference between the free and paid plans?">
+  The main differences include:
+  - **Free**: Basic features, Mintlify subdomain, community support
+  - **Paid plans**: Custom domains, authentication, advanced analytics, priority support, white-label options, and additional customization features
+</Accordion>
+
+<Accordion title="Can I upgrade or downgrade my plan?">
+  Yes, you can change your plan at any time. Upgrades take effect immediately, while downgrades take effect at the end of your current billing cycle. Your documentation remains accessible during plan changes.
+</Accordion>
+
+## Troubleshooting
+
+<Accordion title="My documentation isn't updating after I make changes">
+  If your changes aren't appearing:
+  1. Check that your files are properly saved
+  2. Ensure your `mint.json` configuration is valid
+  3. Clear your browser cache
+  4. For deployed sites, check if your deployment completed successfully
+  5. Verify that your file paths in navigation match your actual file structure
+</Accordion>
+
+<Accordion title="I'm getting build errors when deploying">
+  Common build issues and solutions:
+  - **Invalid JSON**: Validate your `mint.json` file syntax
+  - **Missing files**: Ensure all referenced files in navigation exist
+  - **Image issues**: Check that image paths are correct and files exist
+  - **Component errors**: Verify that all Mintlify components are properly formatted
+</Accordion>
+
+<Accordion title="How do I fix broken links in my documentation?">
+  To fix broken links:
+  1. Use relative paths for internal links
+  2. Ensure file extensions match your actual files (.mdx or .md)
+  3. Check that referenced files exist in your project
+  4. Use the correct case for file names (case-sensitive)
+  5. Update navigation in `mint.json` to match your file structure
+</Accordion>
+
+<Accordion title="My custom styling isn't working">
+  If custom styles aren't applying:
+  1. Ensure your CSS file is properly referenced in `mint.json`
+  2. Check CSS syntax and specificity
+  3. Verify that custom CSS is supported on your plan
+  4. Clear browser cache and hard refresh
+  5. Use browser developer tools to debug styling issues
+</Accordion>
+
+## Support and Resources
+
+<Accordion title="Where can I get help if I'm stuck?">
+  Mintlify offers several support channels:
+  - **Documentation**: Comprehensive guides and tutorials
+  - **Community Discord**: Connect with other users and get community support
+  - **GitHub Issues**: Report bugs and request features
+  - **Email Support**: Direct support for paid plan users
+  - **Office Hours**: Regular community calls for questions and feedback
+</Accordion>
+
+<Accordion title="How do I report a bug or request a feature?">
+  You can report bugs or request features through:
+  - GitHub Issues on the Mintlify repository
+  - Community Discord server
+  - Email support (for paid users)
+  - Feature request form on the Mintlify website
+</Accordion>
+
+<Accordion title="Are there examples of documentation built with Mintlify?">
+  Yes! You can find examples and inspiration in:
+  - Mintlify's showcase page featuring customer documentation
+  - The Mintlify documentation itself (built with Mintlify)
+  - Community Discord where users share their projects
+  - GitHub repositories with open-source Mintlify projects
+</Accordion>
+
+---
+
+Still have questions? Join our [Discord community](https://discord.gg/mintlify) or check out our [documentation](/) for more detailed guides and tutorials.