TGViewer
C++ - Reddit C++ - Reddit @r_cpp · 229 subscribers
Post #25794 5
I built MrDocs, an open-source C++ reference doc generator on the Clang/LLVM AST. Looking for feedback.

I'm Alan de Freitas, the lead developer of MrDocs. It's an open-source documentation generator from the C++ Alliance, built on Clang/LLVM. It reads your code from the compiler's AST, so the reference matches what the code actually compiles to. We also presented [a session](https://cppcon2026.sched.com/event/2RT70/mrdocs-reliable-reference-documentation-for-c++-using-the-clang-ast) about it at cppcon this year.

I implemented the tool this way because we couldn’t come up with a workflow that understood modern C++ in our Boost libraries. Tools that parse partially tend to misrender or not render concepts, niebloids, SFINAE, overload sets, and deduction guides. MrDocs treats those as first-class:

* concept constraints and requires clauses preserved verbatim
* niebloids and function objects can be documented as callables
* SFINAE and concept overload sets kept together
* explicit, noexcept, and consteval specifiers captured
* types in detail or private namespaces rendered as implementation-defined

The presentation layer is completely encapsulated. Generators support HTML, AsciiDoc, XML, JSON, or any custom format like Markdown and LaTeX, without forking the tool or creating another post-processing workflow. You can also write extensions to apply project conventions to the corpus or define new generators for any use case. The documentation has lots of examples.

If you maintain reference docs for a library, I'd appreciate it if you gave it a run (or tell your favorite agent to) and reported back on whether it saves you time, both while writing docs and while reviewing them. First-hand numbers would be especially useful to me. Issues are also always welcome.

Site:[ https://www.mrdocs.com](https://www.mrdocs.com/)Repo:[ https://github.com/cppalliance/mrdocs](https://github.com/cppalliance/mrdocs)

Happy to answer questions in the comments.

https://redd.it/1wz3115
@r_cpp
Sched CppCon 2026: MrDocs: Reliable Reference Documentation... View more about this event at CppCon 2026
More from @r_cpp
  1. Oct 6, 2026WasmBolt — The LLVM Project in your browser https://anutosh21.github.io/WasmBolt/ https://…
  2. Oct 6, 2026How I speed up my overall build times by 4x and incremental builds by 9x for test builds *…
  3. Oct 6, 2026Why do people on Windows mostly choose Visual Studio? https://redd.it/1weku08 @r_cpp
  4. Oct 6, 2026Jonas Persson: Making every byte count https://youtu.be/GbwrztrY4kc https://redd.it/1wf1l3…
  5. Oct 6, 2026It annoys me that coroutines are described as "functions that can be suspended" Any functi…
  6. Oct 6, 2026==2896379== logger no timeout configured, using default 1000 ms ==2896379== ==2896379== HE…
Threads Profile ViewerView any public Threads profile without an account.Open ThreadLook →Writing with AI? Make it sound human.Metric37 rewrites AI drafts so they read naturally. Free AI detector, 1,500 words free.Try Metric37 →