[PATCH] D87242: [flang] Add new documentation main page

[Richard Barton via Phabricator via llvm-commits]

richard.barton.arm added a comment.

In D87242#2259691 <https://reviews.llvm.org/D87242#2259691>, @sameeranjoshi wrote:

> I have a `GettingInvolved.md` can you include it as well if it makes sense to add it with this patch and the original authors agree.
> Most of the content comes from mailing list meeting minutes from Gary(Thanks @gak).F12877278: GettingInvolved.md <https://reviews.llvm.org/F12877278>

Nice addition! I suggest doing what you have done and making D87270 <https://reviews.llvm.org/D87270> depend on this change and we submit them in that order.

> Is there a hard requirement for using `rst`, can we instead use links from markdown syntax for generating TOC?
> TOC generators could be used initially.

>From what I have seen of your recent work @sameeranjoshi, I think it is likely that you know more about this than I do so I went and had a look :-)

The internet suggests the AutoStructify <https://recommonmark.readthedocs.io/en/latest/auto_structify.html> recommonmark extension is the one. I will take a look.



================
Comment at: flang/docs/index.rst:1
+.. Flang documentation master file.
+   You can adapt this file completely to your liking, but it should at least
----------------
sameeranjoshi wrote:
> Is there a hard requirement for using `rst`, can we instead use links from markdown syntax for generating TOC?
> TOC generators could be used initially.
> Is there a hard requirement for using `rst`, can we instead use links from markdown syntax for generating TOC?
> TOC generators could be used initially.




Repository:
  rG LLVM Github Monorepo

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

https://reviews.llvm.org/D87242