[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