<div style="font-family: arial, helvetica, sans-serif"><font size="2"><div class="gmail_quote">On Wed, Jun 13, 2012 at 3:41 PM, Mikael Lyngvig <span dir="ltr"><<a href="mailto:mikael@lyngvig.org" target="_blank">mikael@lyngvig.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Guys, that was very interesting and useful stuff you preached there.  Mind if I make a patch to the FAQ and include it somewhere?  <div>
<br></div><div>"Q: When should I develop against a branch?  A: Only if you are making really big or controversial changes.  ... blah blah</div>
<div><br></div><div>I am thinking that it would be highly useful for the project, if somebody (yours sincerely) took it upon himself to hunt and gather the very interesting bits that often pop up in these mailing lists.  As a newbie, I think the lists are very valuable, but you cannot expect people to always read all of the old stuff on the lists and as much as we all love Google's search engine (bing! bing!), it does always find the stuff you want to find (nearly, but not always).</div>
</blockquote><div><br></div><div>Yes, patches to the FAQ are very welcome.</div><div><br></div><div>We should honestly organize the FAQ a bit differently if you want to start really working to flesh it out with more useful information. I think there should be three FAQs at least:</div>
<div><br></div><div>1) A FAQ for the LLVM Project, which is applicable to LLVM, Clang, and often other subprojects. This would include the license section in the current LLVM faq, and maybe some other points.</div><div><br>
</div><div>2) A FAQ for the LLVM codebase -- specific to the code, libraries, and infrastructure in the primary project.</div><div><br></div><div>3) A Clang FAQ for the FE-specific stuff.</div><div><br></div><div><br></div>
<div>The current FAQ is mostly #2, with a bit of #1, and a lot of out-of-date or flat out wrong information. The current FAQ could probably stay as one page, or be two pages, but it should have a clear and well deliniated split between #1 and #2. We should discuss creating #3 on cfe-dev in a separate thread if you're interested.</div>
<div><br></div><div><br></div><div>If you're proposing patches, here are some suggestions as the standard process may not work as well... which others may contradict if they disagree... ;]</div><div><br></div><div>- Patches to fix the formatting / structure should go directly to llvm-commits</div>
<div><br></div><div>- Patches to add a FAQ entry to section #1 above should at least go to llvm-commits, llvmdev, and possibly a few of the mailing lists for suprojects to get wider feedback.</div><div><br></div><div>- Patches to add a FAQ entry to section #2 above should go to llvm-commits and llvmdev.</div>
</div></font></div>