Hello,<br><br><div class="gmail_quote">On Mon, Jan 2, 2012 at 15:35, Juan Fatas Huang <span dir="ltr"><<a href="mailto:katehuang0320@gmail.com">katehuang0320@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<font face="arial, helvetica, sans-serif">How about Sphinx?</font><div><font face="arial, helvetica, sans-serif"></font></div></blockquote></div><br><div>I think that Sphinx collides with having Scribble -- the documentation toolset for Racket (and not only).</div>
<div><br></div><div>Back to the Python department, I was reading some documentation today, and I found specifically helpful to have this FAQ => <a href="http://docs.python.org/faq/programming.html">http://docs.python.org/faq/programming.html</a></div>
<div><br></div><div>I think I haven't used it before. I was reading about how to distribute standalone binaries, and the FAQ came as one of Google's results.</div><div><br></div><div><br></div><div>For Racket, a FAQ could cover commons questions that show up in the mailing-list or IRC. Example:</div>
<div><br></div><div>1. Why do I get an error ...?</div><div>Make sure to set "detect language from source"</div><div><br></div><div>2. How to distribute binaries?</div><div>...</div><div><br></div><div>3. Where is the documentation for slideshows?</div>
<div>...</div><div><br></div><div>4. Can I do this ... in Racket?</div><div>...</div><div><br></div><div>etc...</div><div><br></div><div><br></div><div>It would be helpful if the FAQ would concentrate more links and short explanations to things that are better documented or exemplified somewhere else.</div>
<div><br></div><div><br></div><div><br></div><div>Additionally, by reading the list I've heard about many contributions spread in Github or personal pages, for example one Github page with a list of pet projects.</div>
<div>I think there could be a section somehow in the Racket website to link to those contributions, or else it gets more difficult to remember that they exist, and where they are. Maybe something in the already existent community page?</div>
<div><br></div><div><br></div><div>[]'s</div><div><br clear="all">Rodolfo Carvalho</div>