diff --git a/docs.json b/docs.json
index e0ab9a57e..38137d248 100644
--- a/docs.json
+++ b/docs.json
@@ -208,7 +208,6 @@
"advanced/dashboard/sso",
"advanced/dashboard/permissions",
"advanced/dashboard/roles"
-
]
}
]
diff --git a/why-docs-are-cool.mdx b/why-docs-are-cool.mdx
new file mode 100644
index 000000000..b3c7b3772
--- /dev/null
+++ b/why-docs-are-cool.mdx
@@ -0,0 +1,117 @@
+---
+title: 'Why Documentation is Cool'
+description: 'Discover the amazing benefits of great documentation and why it's essential for modern software development'
+---
+
+# Why Documentation is Cool
+
+Documentation isn't just a necessary evil - it's a powerful tool that can transform your project, delight your users, and build thriving communities. Let's explore why documentation deserves more love and attention.
+
+## Supercharging User Experience 🚀
+
+
+Well-crafted documentation can reduce user frustration by up to 90% and dramatically increase product adoption rates.
+
+
+Great documentation:
+- Helps users get started quickly
+- Provides clear pathways to advanced features
+- Answers questions before they're asked
+- Builds user confidence and competence
+
+## Accelerating Development âš¡
+
+```mermaid
+graph LR
+ A[Good Docs] --> B[Faster Onboarding]
+ A --> C[Clear Standards]
+ A --> D[Knowledge Sharing]
+ B --> E[Increased Productivity]
+ C --> E
+ D --> E
+```
+
+Documentation supercharges development by:
+- Reducing onboarding time for new team members
+- Preserving critical knowledge and decision rationale
+- Setting clear standards and best practices
+- Enabling asynchronous collaboration
+
+## Lightening Support Burden 🎯
+
+
+
+ Good documentation can reduce support tickets by up to 60%
+
+
+ Documentation helps support teams resolve issues more quickly
+
+
+
+When documentation is thorough and accessible:
+- Users can self-serve answers to common questions
+- Support teams can reference standardized solutions
+- Complex issues are easier to diagnose and resolve
+- Knowledge base becomes a valuable support asset
+
+## Building Community 🌟
+
+Documentation plays a vital role in building and nurturing communities by:
+- Creating a shared understanding
+- Enabling contribution from new members
+- Establishing project culture and values
+- Facilitating knowledge exchange
+
+
+
+
+
+## Best Practices for Cool Docs
+
+1. **Keep it Fresh**
+ - Regular updates maintain relevance
+ - Version control ensures accuracy
+ - User feedback drives improvements
+
+2. **Make it Accessible**
+ - Clear navigation
+ - Searchable content
+ - Multiple learning styles (text, diagrams, examples)
+
+3. **Show, Don't Just Tell**
+ - Code examples
+ - Interactive tutorials
+ - Visual guides
+
+
+Remember: The best documentation is the one that gets read and used. Focus on clarity, accessibility, and user needs.
+
+
+## Documentation ROI
+
+Good documentation delivers measurable returns:
+- Reduced support costs
+- Faster development cycles
+- Improved user satisfaction
+- Increased product adoption
+- Stronger community engagement
+
+## Getting Started
+
+Ready to make your documentation cool? Start with:
+1. Audit your current documentation
+2. Identify key user needs
+3. Create a documentation strategy
+4. Implement modern documentation tools
+5. Gather and act on feedback
+
+
+Documentation isn't just about writing - it's about empowering users, supporting growth, and building lasting value for your project.
+
+
+## Resources
+
+Want to learn more about creating awesome documentation? Check out these resources:
+- [Documentation Best Practices Guide](/docs/best-practices)
+- [Tool Recommendations](/docs/tools)
+- [Community Guidelines](/docs/community)
\ No newline at end of file