Publishing Arabic documentation: what RTL-first actually takes
What it takes to publish Arabic documentation well: logical CSS, bidirectional text, Arabic search tokenization, per-language trees, hreflang, and fonts.
Guides and notes from building Nibleaf — self-hosting, Markdown, bilingual documentation, and honest looks at the docs tooling landscape.
Why plain Markdown is the portability contract for documentation — greppable, diffable, AI-ready — and how a visual editor can round-trip it cleanly.
Nibleaf is an open-source, self-hostable Mintlify alternative with a WYSIWYG Markdown editor, versioned publishing, built-in search, and real Arabic support.
An honest comparison of Docusaurus, MkDocs Material, Starlight, Fumadocs, BookStack, Wiki.js, and Nibleaf: authoring, search, i18n/RTL, hosting.
A practical walkthrough for self-hosting a documentation site with Docker Compose: server sizing, .env secrets, custom domains, backups, and upgrades.
Start free on Nibleaf Cloud, or self-host the same open-source platform on your own servers.