I know what you are about to say  : « Oh no, why a new documentation tooling ? Doc is useless»

Well, you're kind of right, and I'm sure that any developer have already experienced it : documentation can be useless. It is always outdated and never accurately describes your software, so no one actually uses it.

Let's first try to understand what's wrong with our documentation.