<div style="font-family: arial, helvetica, sans-serif"><font size="2"><div class="gmail_quote">On Wed, Jun 13, 2012 at 4:37 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">I think the best way that I can currently contribute to the project is through technical writing.  So I see myself as doing a serious, long-term project of extending the FAQ.  So, I can affirm that I want to really start working :)</blockquote>
<div><br></div><div>Awesome.</div><div><br></div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div><div>I was myself thinking of a number of FAQs:</div><div><br></div>
<div>1. A General FAQ with high level questions like "What is the license?", "What is LLVM?", and "What is Clang?"  Something that lifts the newcomer up to a fairly knowledgable state in a short time.</div>
</div></blockquote><div><br></div><div>SGTM.</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div>
<div>2. An LLVM User FAQ that only deals with LLVM usage questions.</div><div>3. An LLVM Dev FAQ that only deals with LLVM development questions.</div><div>4. A Clang User FAQ that only deals with Clang usage questions.</div>

<div>5. A Clang Dev FAQ that only deals with Clang development questions.</div><div>6. A you-name-it User FAQ that (lld comes to mind)...</div><div>7. A you-name-it Dev FAQ that...</div><div>8. A Technical Writer FAQ (should include the Sphinx documentation from the lld docs).</div>
</div></blockquote><div><br></div><div>All of these we usually deal with as manuals rather than FAQs, and I think that's a better strategy overall. We should ensure we have thorough and complete manuals, and only add FAQs to cover completely off-the-wall information that doesn't really have a good home, or a quick 10 questions that are almost always asked.</div>
<div><br></div><div>Also, I think there should be only one manual for LLVM -- the line between 'user' and 'developer' is too blurry to be sensible in documentation. The organization of the documentation itself will naturally group things appropriately so that only the relevant sections need be read.</div>
<div><br></div><div>Finally, I would focus on "user facing" FAQs for the quick 10 questions. I don't think developers will really be helped by these as often.</div></div></font></div>