<div dir="ltr"><div class="gmail_extra"><div><div class="gmail_signature">On Mon, Mar 26, 2018 at 3:10 PM, Chandler Carruth via Phabricator <span dir="ltr"><<a href="mailto:reviews@reviews.llvm.org" target="_blank">reviews@reviews.llvm.org</a>></span> wrote:<br></div></div><div class="gmail_quote"><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">chandlerc added a comment.<br>
<br>
FWIW, I'm really, really happy to have this. =D<br>
<br>
But we should hear from others whether they're happy with this direction. </blockquote><div><br></div><div>Should this (or just an RFC) go to llvm-dev to get more input?</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">Also, should we update any of our documentation recommending one format or the other? I feel like markdown has "won" in the same sense that GitHub has "won" -- it's the place with the growing ecosystem, even when its functionality is actually inferior to reStructuredText. My inclination is always to go with ecosystem, but others may have different opinions here.<br>
<br></blockquote><div><br></div><div>There are some major things that markdown is missing like cross document references and toctree, however recommonmark has some direct support for those (although this patch doesn't enable all of them) and supports escaping to r<span style="color:rgb(34,34,34);font-family:arial,sans-serif;font-size:small;font-style:normal;font-variant-ligatures:normal;font-variant-caps:normal;font-weight:400;letter-spacing:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px;background-color:rgb(255,255,255);text-decoration-style:initial;text-decoration-color:initial;float:none;display:inline">eStructuredText.  I'm fine with writing new docs in markdown + extensions-when-needed, but I'm a bit concerned with rewriting the existing documentation (including LangRef) in markdown due to the work it will take.</span></div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
<br>
================<br>
Comment at: docs/<wbr>MarkdownQuickstartTemplate.md:<wbr>102<br>
+<br>
+``` C++<br>
+int main() {<br>
----------------<br>
capital or lowercase `c` here?<br>
<br></blockquote><div><br></div><div>Looks like it's case insensitive.  It's documented as lowercase: <a href="http://pygments.org/docs/lexers/">http://pygments.org/docs/lexers/</a> .</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">
<br>
<a href="https://reviews.llvm.org/D44910" rel="noreferrer" target="_blank">https://reviews.llvm.org/<wbr>D44910</a><br>
<br>
<br>
<br>
</blockquote></div><br></div></div>