[flang-commits] [PATCH] D86131: [FLANG] Pick `.md` files when building sphinx documentation.

Kiran Chandramohan via Phabricator via flang-commits flang-commits at lists.llvm.org
Tue Aug 18 13:10:00 PDT 2020


kiranchandramohan added inline comments.


================
Comment at: flang/README.md:225
+!>
+Flang documentation should preferably be written in `markdown(.md)` documentation format(they can be in `reStructuredText(.rst)` format as well but markdown is recommended in first place), it
+is mostly meant to be processed by the Sphinx documentation generation
----------------
Nit: Suggestion: preferably be written in `markdown(.md)` documentation format -> preferably be written in `markdown(.md)` syntax
Nit: space between format and (.


================
Comment at: flang/docs/conf.py:31
 
+extensions = ['recommonmark']
+
----------------
Is this over-riding the assignment to extensions above? If so can the one above be removed?


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

https://reviews.llvm.org/D86131



More information about the flang-commits mailing list