Skip to main content

3 posts tagged with "docusaurus"

View All Tags

Docusaurus vs Sphinx: Choosing the Right Documentation Tool

· 15 min read
Faycal Alami-Hassani
Founder of Farowave

If you've spent time writing technical documentation, you've almost certainly encountered both Sphinx and Docusaurus. They're both widely used, both open source, and both capable of producing polished documentation sites — but they are built on fundamentally different assumptions about who is writing the docs, what the docs need to do, and how much structural control matters.

This article is a practical comparison based on hands-on experience with both tools. The goal isn't to declare a winner, but to give you a clear picture of where each tool excels so you can make an informed choice for your project.

Unmet Dependencies in Docusaurus

· 4 min read
Faycal Alami-Hassani
Founder of Farowave

This is the first time that I am facing issues with unmet dependencies in Docusaurus after a Yarn Upgrade.

What is Docusaurus?

Docusaurus is an SSG (short for Static Site Generator). Static Site Generators are software frameworks that generate static HTML webpages using templates, components, and plain-text files.

The plain-text files make use of markup languages such as Markdown. Since there are neither databases nor dynamic content involved, the static HTML files load pretty fast.

Entering Text Mode in Fedora

· 2 min read
Faycal Alami-Hassani
Founder of Farowave
note

The following blog post is a self-reminder for troubleshooting Linux distros when access to graphical mode is not possible.

I recently messed up the SELinux configuration on a Fedora distro while trying to relabel the filesystem on boot with this command:

fixfiles -B onboot

After running the command and restarting the OS, the relabeling process was failing repeatedly, leading my system to an infinite reboot loop.