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

[Nikita Popov via llvm-branch-commits]

nikic wrote:

> Can we use "markdown syntax tables" in the conversion (quite similar to the tables syntax used in rST format), instead of "list tables" (terminology from https://myst-parser.readthedocs.io/en/latest/syntax/tables.html#markdown-syntax)?

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). For tables where all the entries are small, the "table" formatting is nicer, but for those with large entries list-tables are preferable.

For example, the old formatting of the "Recognized test mask names" table was nicer, but conversely I think the new one for the table containing "A vararg function that takes at least one" is better.

I assume the ask here is to keep the same style as whatever the rst file used, rather than using the non-list tables always?

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