Automatic Documentation Generation to the gitlab wiki

Problem to solve

Code changes rapidly and some projects just move really fast. It happens a lot that you may write docs today that will be outdated a few months later. That is why writing documentation within the code can be very helpful.

Further details

Current solutions like doxygen and sphinx work fine. But for a C++ programmer like me. I really wish I could harness the power of gitlab wiki pages automatically from within my code. Especially that tools like doxygen are becoming really old (and not so good looking).

Proposal

Imagine the scenario that I am writing my C++ code along with necessary documentation comments. I push and a certain service is triggered (optionally when CI passes?) that will scan my code for comments and generates gitlab wiki pages for me.