The Real Scope Behind the rsyslog Documentation Overhaul

For a concise Computer Science summary of this effort, see the section at the end of this article.

When I began the current documentation overhaul, the objective was never limited to cleaning up a few pages. From the beginning, the plan was to prepare rsyslog for the AI era. And the truth is simple: without modern AI tooling, this work would not have been feasible at this depth or speed.

Symbolic illustration showing documentation, an AI head, and a graph structure representing RAG.
Continue reading “The Real Scope Behind the rsyslog Documentation Overhaul”

Outdated readthedocs problem solved!

I am glad to tell that I finally managed to solve an issue that caused confusion for years. Someone had cloned and published the rsyslog documentation at readthedocs. Unfortunately, it was not maintained afterwards and also looked like an official rsyslog doc. That added a lot to the “rsyslog’s doc is bad and inconsistent” feel inside the community. This could now be resolved, and current, official doc is now available at readthedocs. I am very happy and glad for readthedocs staff members who helped us to finally resolve the issue.

The current rsyslog documentation is finally shown at readthedocs. (Screenshot: 2025-09-18, Rainer Gerhards)
Continue reading “Outdated readthedocs problem solved!”

Dogfooding the rsyslog Commit AI Assistant

I’ve been using AI to help with commit messages for a while now. Yesterday, in a discussion with co-workers, it became clear that this may not just be a convenience feature — it’s turning into a real time saver.

That was the background for creating the new rsyslog Commit AI Assistant. It directly addresses a problem we ourselves face in daily development. True to dogfooding, we now use it internally whenever we craft a commit message — myself included.

The “rsyslog commit assistant” in action. You can even see my typos ;-) (Screenshot: Rainer Gerhards, actual session)

Want to give it a try: use the rsyslog commit Assistant.

Continue reading “Dogfooding the rsyslog Commit AI Assistant”

Evolving rsyslog Documentation with AI: From Chaos to a Plan

TL;DR: The rsyslog documentation was a mess — and I knew it. It’s now only “partly OK”, but for the first time we have a clear structure, concept, and plan. AI support, combined with my review and technical expertise, is making this transformation possible — and AI is improving at an impressive pace.
(This post was generated with AI support and fully reviewed and revised by me.)

The rsyslog documentation – an important part of the system. (image: Rainer Gerhards/AI)
Continue reading “Evolving rsyslog Documentation with AI: From Chaos to a Plan”