mintlify · mintlify-development · Sep 26, 2025 · Sep 26, 2025 · Sep 26, 2025 · Sep 26, 2025
diff --git a/contributing.mdx b/contributing.mdx
@@ -0,0 +1,82 @@
+---
+title: "Contributing"
+description: "Learn how to contribute to Mintlify documentation and help improve the developer experience"
+icon: "heart"
+---
+
+We welcome contributions to Mintlify documentation! Whether you're fixing a typo, improving an explanation, or adding new content, your help makes our documentation better for everyone.
+
+## Ways to contribute
+
+### Report issues
+
+Found a problem with our documentation? Help us fix it:
+
+- **Broken links**: Report any links that don't work
+- **Outdated information**: Let us know if content is no longer accurate
+- **Missing information**: Suggest topics that need better coverage
+- **Unclear explanations**: Point out sections that could be clearer
+
+[Report an issue on GitHub](https://github.com/mintlify/docs/issues/new)
+
+### Suggest improvements
+
+Have ideas for making our documentation better?
+
+- **New guides**: Suggest tutorials or guides that would help users
+- **Better examples**: Propose more practical or clearer code examples
+- **UI improvements**: Share ideas for better navigation or layout
+- **Content organization**: Suggest ways to restructure information
+
+[Start a discussion on GitHub](https://github.com/mintlify/docs/discussions)
+
+### Submit changes
+
+Ready to contribute directly? Here's how:
+
+1. **Fork the repository**: Create your own copy of the [docs repository](https://github.com/mintlify/docs)
+2. **Make your changes**: Edit the relevant MDX files
+3. **Test locally**: Run `mint dev` to preview your changes
+4. **Submit a pull request**: Describe your changes and why they're helpful
+
+### Documentation standards
+
+When contributing, please follow these guidelines:
+
+- **Use second-person voice**: Write "you" instead of "the user"
+- **Keep headings in sentence case**: "Getting started" not "Getting Started"
+- **Include code examples**: Show practical implementations
+- **Add alt text to images**: Make content accessible
+- **Test all links**: Ensure external links work correctly
+
+## Getting help
+
+Need help with your contribution?
+
+- **Join our community**: Connect with other contributors and maintainers
+- **Ask questions**: Use GitHub discussions for questions about contributing
+- **Review existing issues**: See what others are working on
+
+## Recognition
+
+We appreciate all contributions! Contributors are recognized in:
+
+- **GitHub contributors list**: Automatic recognition for merged pull requests
+- **Release notes**: Major contributions highlighted in updates
+- **Community showcases**: Outstanding contributions featured in our community
+
+## Code of conduct
+
+We're committed to providing a welcoming and inclusive environment. Please:
+
+- **Be respectful**: Treat all community members with kindness
+- **Be constructive**: Provide helpful feedback and suggestions
+- **Be patient**: Remember that everyone is learning and contributing in their spare time
+
+## License
+
+By contributing to Mintlify documentation, you agree that your contributions will be licensed under the same terms as the project.
+
+---
+
+Thank you for helping make Mintlify documentation better for everyone! 🎉
diff --git a/index.mdx b/index.mdx
@@ -1,6 +1,6 @@
 ---
 title: "Introduction"
-description: "Meet the next generation of documentation. AI-native, beautiful out-of-the-box, and built for developers."
+description: "Mintlify solves the problem of creating and maintaining developer documentation that's both beautiful and functional, without requiring extensive technical setup."
 icon: "book-open"
 mode: "custom"
 ---
@@ -21,8 +21,8 @@
      </h3>
      <span className="mt-1.5">{description}</span>
    </a>
  );
 };

 <div className="relative">
  <div className="absolute top-0 lg:-top-16 left-0 right-0">
@@ -42,7 +42,7 @@
     </h1>
 
     <div className="max-w-xl mx-auto px-4 mt-4 text-lg text-center text-gray-500 dark:text-zinc-500">
-      Meet the next generation of documentation. AI-native, beautiful out-of-the-box, and built for developers.
+      Mintlify solves the problem of creating and maintaining developer documentation that's both beautiful and functional, without requiring extensive technical setup.
     </div>
 
     <div className="px-6 lg:px-0 mt-12 lg:mt-24 grid sm:grid-cols-2 gap-x-6 gap-y-4">

diff --git a/license.mdx b/license.mdx
@@ -0,0 +1,55 @@
+---
+title: "License"
+description: "License information for Mintlify documentation and platform"
+icon: "scale-balanced"
+---
+
+## Documentation License
+
+The Mintlify documentation is licensed under the [MIT License](https://opensource.org/licenses/MIT).
+
+### MIT License
+
+```
+MIT License
+
+Copyright (c) 2024 Mintlify
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+```
+
+## Platform License
+
+The Mintlify platform and CLI tools are proprietary software owned by Mintlify, Inc.
+
+### Terms of Service
+
+Use of the Mintlify platform is governed by our [Terms of Service](https://mintlify.com/terms).
+
+### Privacy Policy
+
+Your privacy is important to us. Please review our [Privacy Policy](https://mintlify.com/privacy) to understand how we collect, use, and protect your information.
+
+## Third-Party Licenses
+
+Mintlify uses various open-source libraries and tools. For a complete list of third-party licenses, please refer to our [dependency licenses](https://github.com/mintlify/docs/blob/main/LICENSES.md).
+
+## Questions
+
+If you have questions about licensing, please contact us at [[email protected]](mailto:[email protected]).
diff --git a/quickstart.mdx b/quickstart.mdx
@@ -6,8 +6,33 @@

 This quickstart guide shows you how to set up and deploy your documentation site in minutes.
 
 After completing this guide, you will have a live documentation site ready to customize and expand.
 
+## Quick example
+
+Here's a simple example of what you can create with Mintlify:
+
+```mdx hello.mdx
+---
+title: "My First Page"
+description: "Welcome to my documentation"
+---
+
+# Hello World
+
+This is my first documentation page with Mintlify!
+
+<Tip>
+You can add interactive components like this tip box.
+</Tip>
+
+```bash
+npm install your-package
+```
+
+That's it! Your page is now live and beautiful.
+```
+
 <Info>
 
 **Prerequisites**: Before you begin, [create an account](https://mintlify.com/start) and complete onboarding.
@@ -127,7 +152,7 @@
 mint dev
 ```

 Your preview will be available at `localhost:3000`.

 <Frame>
  <img src="/images/quickstart/mintlify-dev-light.png" alt="Mintlify Dev" className="block dark:hidden" />
@@ -140,7 +165,7 @@

 Mintlify automatically detects the changes, builds your documentation, and deploys the updates to your site. Monitor the deployment status in your GitHub repository commit history or the [dashboard](https://dashboard.mintlify.com).

 After the deployment completes, your latest update will be available at `<your-project-name>.mintlify.app`.

 <Card title="Jump to adding a custom domain" icon="arrow-down" href="#adding-a-custom-domain" horizontal>
  Optionally, skip the web editor workflow and jump to adding a custom domain.
@@ -148,7 +173,7 @@

 ## Web editor workflow

 The web editor workflow provides a what-you-see-is-what-you-get (WYSIWYG) interface for creating and editing documentation. This workflow is best for people who want to work in their web browser without additional local development tools.

 ### Access the web editor

@@ -156,7 +181,7 @@
 2. Select **Editor** on the left sidebar.

 <Info>
  If you have not installed the GitHub App, you will be prompted to install the app when you open the web editor.
 </Info>

 <Frame>
@@ -166,11 +191,11 @@

 ### Edit the documentation

 In the web editor, you can navigate through your documentation files in the sidebar. Let's update the introduction page:

 Find and select `index.mdx` in the file explorer.

 Then, in the editor, update the title field to "Hello World".

 <Frame>
  <img alt="Editing in Web Editor" src="/images/quickstart/web-editor-editing-light.png" className="block dark:hidden" />
@@ -189,7 +214,7 @@
  Use branches to preview and review changes through pull requests before deploying to your live site.
 </Tip>

 For more details about using the web editor, including using branches and pull requests to collaborate and preview changes, see our [web editor documentation](/editor/getting-started).

 ## Adding a custom domain

@@ -202,21 +227,21 @@
  <img src="/images/quickstart/custom-domain-dark.png" alt="Custom Domain" className="hidden dark:block" />
 </Frame>

 Enter your domain (for example, `docs.yourcompany.com`) and follow the provided instructions to configure DNS settings with your domain provider.

 <Table>
 | Record Type | Name | Value | TTL |
 |-------------|------|-------|-----|
 | CNAME | docs (or subdomain) | cname.mintlify.app | 3600 |
 </Table>

 <Info>
  DNS changes can take up to 48 hours to propagate, though changes often complete much sooner.
 </Info>

 ## Next steps

 Congratulations! You have successfully deployed your documentation site with Mintlify. Here are suggested next steps to enhance your documentation:

 <Card title="Configure your global settings" icon="settings" href="settings" horizontal>
  Configure site-wide styling, navigation, integrations, and more with the `docs.json` file.
@@ -246,6 +271,6 @@
    Deployment can take upwards to a few minutes. Check your GitHub Actions (for code-based workflow) or deployment logs in the Mintlify dashboard to ensure there are no build errors.
  </Accordion>
  <Accordion title="Custom domain not connecting">
    Verify that your DNS records are set up correctly and allow sufficient time for DNS propagation (up to 48 hours). You can use tools like [DNSChecker](https://dnschecker.org) to verify your CNAME record.
  </Accordion>
 </AccordionGroup>