pawosm-arm wrote: I think more people need to look into it. AFAIR the plan was that flang does not use the `.rst` files for documentation, it was supposed to rely on the markdown files entirely. https://github.com/llvm/llvm-project/pull/141882