[llvm-branch-commits] [llvm] [docs] Rewrite LangRef.md as Markdown (PR #201975)

James Y Knight via llvm-branch-commits llvm-branch-commits at lists.llvm.org
Thu Jun 11 13:49:59 PDT 2026


jyknight wrote:

> I think which one is preferable depends on the case. The rST file already used both styles (and did not always make the best choice between them). 

I had only noticed the cases where it was switched -- and in many of those, the tabular version is significantly more readable in the source than the list-table version. I do see that there's other cases which currently use `.. list-table::` in the rST. And, at first impression, I'd say that switching (at least some) of those into the tabular format would make _them_ be significantly less readable than the list-table format they use now.

So, yeah, keep existing style would be good, I think.

https://github.com/llvm/llvm-project/pull/201975


More information about the llvm-branch-commits mailing list