<div dir="ltr"><div class="gmail_quote"><div dir="ltr">On Mon, Mar 26, 2018 at 3:30 PM Michael Spencer via llvm-commits <<a href="mailto:llvm-commits@lists.llvm.org">llvm-commits@lists.llvm.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div><div class="m_-8904970389616317673gmail_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></div><div dir="ltr"><div class="gmail_extra"><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></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>Should this (or just an RFC) go to llvm-dev to get more input?</div></div></div></div></blockquote><div><br></div><div>Yeah, I think an RFC to establish direction and answer questions like the below one makes sense. Can be really short and focused.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><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.</span></div></div></div></div></blockquote><div><br></div><div>Nice! This seems to be an effective way to blend the advantages of each system.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div><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">  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></div></blockquote><div><br></div><div>Strongly agreed. I see little or no value in rewriting things. I mostly see value in leveraging the markdown infrastructure when and where we can going forward.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><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/MarkdownQuickstartTemplate.md:102<br>
+<br>
+``` C++<br>
+int main() {<br>
----------------<br>
capital or lowercase `c` here?<br>
<br></blockquote><div><br></div></div></div></div><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div>Looks like it's case insensitive.  It's documented as lowercase: <a href="http://pygments.org/docs/lexers/" target="_blank">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/D44910</a><br>
<br>
<br>
<br>
</blockquote></div><br></div></div>
_______________________________________________<br>
llvm-commits mailing list<br>
<a href="mailto:llvm-commits@lists.llvm.org" target="_blank">llvm-commits@lists.llvm.org</a><br>
<a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-commits" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-commits</a><br>
</blockquote></div></div>