Documentation solutions like Notion are surprisingly bad at search, even though searchability is one of the most important aspects of documentation.
- Documentation tool based on text-based files (🔻 Markdown, at most 🔻 MDX) and 💾 Git.
- Using text-based formats makes it easier to search and keeps file sizes low
- Files are stored in a git repository and automatically synced locally
- The search engine runs locally (think the
contentIndex.jsonfrom 💎 Quartz)- Due to low file sizes, this is most likely very realistic to even run pretty sizeable documentation hubs
- Suggestions for improvements should be very low-threshold to make and apply, for example, by using PRs under the hood.