Documentation Improvements - FAQ, Book and GitLab

By Ribbon on

In February I decided to contribute to Redox after following it since 2016, as an obvious movement I tried to build Redox on my Fedora and had an error with NetSurf recipe compilation (fixed when I installed the Vim package), as I didn’t know how to customize the Redox build system, I used Podman and it was very slow for a unknown reason (very boring to my testing workflow).

After some time I learned how to customize the build system, removed the NetSurf recipe and the build finished without an error.

The book was not clear/complete and a FAQ was not available, then I decided to improve this as my first contribution to the Redox project.

Thanks Ron Williams, Jeremy Soller and 4lDO2 for your help with my questions.


Every project should have a FAQ for newcomers, it ease their life a lot and brings more interest to the project as the questions are satisfied.

Redox lacked one for years, probably because the developers were busy with the code, then I decide to create one.

I wrote the FAQ in a way that even Unix/Linux newcomers can understand, it’s similar to the BSD system FAQs and wikis.

(I maintain the Portuguese translation too)

Book improvements

(The book cover the high-level documentation and not the code APIs, read this page to understand)

Some parts of the book were outdated for years because the developers were busy with the code, Ron Williams improved it since the end of 2022 and I continued where he left.

Around 95% of the book was improved and new pages were created by me to improve the organization, hundreds of hours of work and thousands of lines changed (Me and Ron are deciding how to organize it properly, we both agree that the book must hold cold information while the website hold the hot information).

Like the FAQ, I decided to document the Redox in the most easy way possible with workflows/methods that cover most use cases in the development.

(I’m the current book maintainer)

A non-exaustive list of my improvements:


I improved some documentation of the GitLab repositories too, generally this information is moved from the book or duplicated for easy access.

A non-exaustive list of my improvements: