Stop the JavaScript madness:
Write your docs with Ruby on Rails
Unleash the
Power of Rails
with HotDocs
..or read the Quickstart
HotDocs is a set of optimized Rails components & tools for writing docs#
It's just Rails
Do you need the database? Or want to reuse code? What about Hotwire? Yes, yes, and yes! As a Rails dev, you'll feel at home.
Focus on the docs
HotDocs covers all your bases, you only need to author the content. Html and Markdown support included.
Static export
Export Html and Css for speed while allowing some elements to fetch fresh content from a backend.
Goals#
- Lean on Rails so you don't have to catch up
- Defaults for 80% of your needs...
- ...escape hatches for 20% of your dreams
- Just one gem & one rake command
Anti-Goals#
- Create new abstractions you have to learn
- Lock you in a new framework for life
- Require a complex setup and many dependencies
- Break features that Rails provides
Comparison with Jekyll & Docusaurus#
| HotDocs | Jekyll | Docusaurus | |
|---|---|---|---|
| Ruby on Rails (database, Hotwire, etc.) | ✅ | ❌ | ❌ |
| Embed docs in an existing Rails app | ✅ | ❌ | ❌ |
| Standalone docs | ✅ | ✅ | ✅ |
| Styled components you can customize | ✅ | ✅ | ✅ |
| Markdown (with syntax highlight & themes) | 🚀 | 👍 | 🚀 |
| Static export | 🚀 | 👍 | 🚀 |
| Search | ✅ | 🔌 | 🔌 |
| Light / Dark | 🔜 ✅ | 🔌 | ✅ |
| Open source | ✅ | ✅ | ✅ |
| Free | ✅ | ✅ | ✅ |
| Anything missing? Suggestions? Contribute | |||