<div dir="ltr"><br><div class="gmail_extra"><br><br><div class="gmail_quote">On Wed, Nov 13, 2013 at 12:05 AM, Chris Lattner <span dir="ltr"><<a href="mailto:clattner@apple.com" target="_blank">clattner@apple.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div style="word-wrap:break-word"><br><div><div class="im">
<div>On Nov 12, 2013, at 8:29 PM, Sean Silva <<a href="mailto:silvas@purdue.edu" target="_blank">silvas@purdue.edu</a>> wrote:</div><br></div><blockquote type="cite"><div class="im"><div style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px">
<br>Actually I'm really curious about the "users" that<span> </span><a href="http://clang.org/" target="_blank">clang.org</a><span> </span>serves, and I think it would be useful to take those use cases to heart and improve the normal releases correspondingly. E.g. you mentioned somewhere else that the download on<span> </span><a href="http://clang.org/" target="_blank">clang.org</a><span> </span>is code signed? is that something that users would appreciate and that we should integrate into our regular release process?. You also mentioned some stuff like a GUI AST viewer, and nodejs bindings? Are users really digging those? I think those last two would be great to move closer to upstream regardless.</div>
<div style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px">
<br></div></div><div style="font-family:Helvetica;font-size:12px;font-style:normal;font-variant:normal;font-weight:normal;letter-spacing:normal;line-height:normal;text-align:start;text-indent:0px;text-transform:none;white-space:normal;word-spacing:0px">
Also I just wanted to mention Alp, that you've been doing a great job interacting with the community and our development process (incremental development, tests, code review, etc.). (well, this strange<a href="http://clang.org/" target="_blank">clang.org</a><span> </span>scenario aside (although in the end I'm glad that domain is in "friendly hands" and not a squatter or porn ads!))</div>
</blockquote><br></div><div>I think that Alp made a really good point: "Clang" is a developer-facing product that a lot more developers interact with than compiler engineers.  <a href="http://llvm.org" target="_blank">llvm.org</a> and even <a href="http://clang.llvm.org" target="_blank">clang.llvm.org</a> are really focused on bringing people into the open source community and serving us compiler hackers, but it does a really poor job serving users that just want to use a compiler and look up a few options or language extensions.</div>
</div></blockquote><div><br></div><div>When I reorganized the clang docs front page, I was actually amazed at how things fell out. We actually have a quite nice slice of docs that broadly fall under the category "Using Clang as a Compiler" <<a href="http://clang.llvm.org/docs/#using-clang-as-a-compiler">http://clang.llvm.org/docs/#using-clang-as-a-compiler</a>>, and I made sure to put those front and center.<br>
</div><div> <br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div style="word-wrap:break-word"><div>
Oh, and the main web page could really use an update, being almost unmodified since its inception.</div></div></blockquote><div><br></div><div>Yeah it would be nice to have a web site that looks like it was developed by a web designer, not a compiler hacker :) Our dragon logo is awesome, how did that come about? Maybe we could emulate that process to net a fresh fancy webpage. (I'm assuming that the dragon logo wasn't designed by a compiler hacker; if it was, then this is me bowing to their skill).</div>
<div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div style="word-wrap:break-word"><div><br></div>
<div>In many ways, this is the same problem that projects like Eclipse have.  Since eclipse is both a community and an IDE, the main "<a href="http://www.eclipse.org" target="_blank">http://www.eclipse.org</a>" web site is pretty useless for people who just want a Java IDE.  I'm not finding any great examples of open source projects "doing it right", but <a href="http://linux.com" target="_blank">linux.com</a> for example is targeted as users and advocates of the linux OS, not at kernel hackers.</div>
</div></blockquote><div><br></div><div>I think the "normal" way to do it these days (for better or for worse) is for a project's home page to be entirely "non-developer-centric", but have a "github" ribbon/button that developers know to look for. Then the README on github branches out to IRC, mailing lists, and of course the bug tracking and repo are there on github. It works well. Sometimes the "home page" is hosted on github pages too (on http://<username>.<a href="http://github.io/projectname/">github.io/projectname/</a>). Examples:</div>
<div><br></div><div><a href="http://nodejs.org/">http://nodejs.org/</a><br></div><div><a href="http://martine.github.io/ninja/">http://martine.github.io/ninja/</a></div><div><a href="http://kentonv.github.io/capnproto/">http://kentonv.github.io/capnproto/</a></div>
<div><br></div><div>Another common pattern for slightly "older" projects is to make the page primarily "non-developer-centric" but have an easy-to-see "get involved" link.</div><div><br></div>
<div>However, there aren't many projects of the size of LLVM and so it's anybody's guess whether it's meaningful to draw inspiration from these other approaches. I do think it would be nice if we had a really nice README, and that a WebUI source browser with pretty README renderer was just one click away from the homepage (and showing checkout/clone URLs throughout), as that puts people that much closer to checking out the code, which puts them that much closer to sending patches, etc., etc..</div>
<div><br></div><div>Actually, I just did an experiment: from landing on <a href="http://llvm.org">llvm.org</a>, how long does it take me to find a page with a checkout/clone URL? </div><div><br></div><div>(Before reading on, try going to <a href="http://llvm.org">llvm.org</a> and clicking your way to a repository URL)</div>
<div><br></div><div><br></div><div><br></div><div>I was very surprised: it took me like a minute</div><div>The path I found from landing on <a href="http://llvm.org">llvm.org</a> to getting to svn co/git clone is:</div><div>
<a href="http://llvm.org">llvm.org</a> > Documentation > Getting Started with the LLVM System</div><div>It took me >30 seconds (Ctrl+F "SVN", etc.) of head scratching to figure out that Documentation would take me to somewhere with a repo URL. After that I happen to know since I know the docs well that GettingStarted.rst has the clone URL's, but someone who didn't know that would have had a hard time guessing that, and there is a whole division of docs in the way before they would even *see* "Getting Started".</div>
<div>(admittedly, searching for `llvm svn` and `llvm git` does go directly to GettingStarted.rst, so maybe I shouldn't be so alarmed)</div><div><br></div><div>clang is a lot better, it's just <a href="http://clang.llvm.org">clang.llvm.org</a> > "Get started" (although "Get started" is a bit hard to find).</div>
<div><br></div><div>Compare this with the other sites I just mentioned, where the process is just "land on the page" > github, done. This ease also translates to any functionality covered by github, e.g. bug tracker (try finding your way to the llvm bug tracker from <a href="http://llvm.org">llvm.org</a>; the best I was able to do was <a href="http://llvm.org">llvm.org</a> > Documentation > <a href="http://llvm.org/docs/HowToSubmitABug.html">http://llvm.org/docs/HowToSubmitABug.html</a> > "the LLVM Bug Tracking System"; search engine results were fairly good though)</div>
<div><br></div><div>I think it would be beneficial for the project to optimize this path. Most of what I can do is in the docs/ side of things though (I am clueless about the <a href="http://llvm.org">llvm.org</a> website).</div>
<div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex"><div style="word-wrap:break-word"><div><br></div>
<div>I think it could be really great to have a user-centric landing page, and if we do that, making <a href="http://clang.org" target="_blank">clang.org</a> be it would be truly great.</div></div></blockquote><div><br></div>
<div>Agreed. That sounds like a perfect use for the domain.</div><div><br></div><div>-- Sean Silva</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left-width:1px;border-left-color:rgb(204,204,204);border-left-style:solid;padding-left:1ex">
<div style="word-wrap:break-word"><span class=""><font color="#888888"><div><br></div><div>-Chris</div></font></span></div></blockquote></div><br></div></div>