[PATCH] D85828: [Flang] Move mark down documentation(md) files to reStructuredText(rst) file format.

David Truby via Phabricator via llvm-commits llvm-commits at lists.llvm.org
Wed Aug 12 08:16:39 PDT 2020


DavidTruby added a comment.

In D85828#2213245 <https://reviews.llvm.org/D85828#2213245>, @sscalpone wrote:

> I think md is the wave of the future.  Other llvm subproject use md.  Let's stick with what we have unless there's a compelling advantage to using rst or another format.

It's not really correct to say that other llvm subprojects use md: with the exception of MLIR every LLVM subproject uses rst, including LLVM itself.

MLIR hosts a separate website elsewhere, which is why they aren't tied to the same format as everyone else. If we want to do that and render the .md files to html instead then we can, but if we want to be on the same website as the rest of LLVM (except MLIR) we need to use rst as the text format.

That is, at least, my understanding for the motivation behind the change. @sameeranjoshi can probably provide a better explanation as it's his change.


Repository:
  rG LLVM Github Monorepo

CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D85828/new/

https://reviews.llvm.org/D85828



More information about the llvm-commits mailing list