<div dir="ltr"><div>I think there is still value in the "wall of text" (although I personally prefer the TL;DR) : it explains the context, provides examples --- and it seems to be important for many people in the community. The expected behaviors should stand-out though --- that's why they are in bold font in the wall of text, but moving them in the "prologue/ToC" and making them appear as links ensure no-one can miss them.</div><div><br></div></div><div class="gmail_extra"><br><div class="gmail_quote">On Fri, May 6, 2016 at 4:59 PM, C Bergström <span dir="ltr"><<a href="mailto:llvm-dev@lists.llvm.org" target="_blank">llvm-dev@lists.llvm.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><span class="">On Fri, May 6, 2016 at 10:55 PM, Neil Henning via llvm-dev<br>
<<a href="mailto:llvm-dev@lists.llvm.org">llvm-dev@lists.llvm.org</a>> wrote:<br>
> +1 for this TL;DR suggestion - you can guarantee most people would read < 7<br>
> short bullet points.<br>
<br>
</span>If this is sufficient, then why have the wall of text? Like a prologue?<br>
<div class="HOEnZb"><div class="h5">_______________________________________________<br>
LLVM Developers mailing list<br>
<a href="mailto:llvm-dev@lists.llvm.org">llvm-dev@lists.llvm.org</a><br>
<a href="http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev" rel="noreferrer" target="_blank">http://lists.llvm.org/cgi-bin/mailman/listinfo/llvm-dev</a><br>
</div></div></blockquote></div><br></div>