Mark Hubbart
10/23/2004 12:28:00 AM
On Sat, 23 Oct 2004 02:32:40 +0900, Richard Lyman <lymans@gmail.com> wrote:
> Sorry to be bugging you so much.... but I can't stop loving the new
> functionality and setup!!
>
> What about allowing this FAQ to branch out?
>
> Could RubyForge tie into this so that any project on RubyForge would
> have FAQ-ability using the same username and passwords - same URL?
>
> I ask this because I'd love to have the ability to centralize
> question/answer stuff, and more importantly to actually have it. There
> are so many projects where because of lanugage barriers, or because of
> age or neglect, a project becomes unuseable. The ruby community would
> greatly benefit from a php.net styl of docs+user_comments in the form
> of a centralized FAQ.
>
> Imagine being curious about a module someone had provided on
> RubyForge, downloading it to find that the code might be fantastic but
> the documentation non-existent. This is where a centralized community
> contributed FAQ would shine. I'm trying to do something in Ruby but
> can't seem to figure it out on my own, I search the Ruby FAQ. If I
> don't find anything, I post a question. A group that had previously
> volunteered to 'support' that module/library/application would be
> notified via email of my pending question(s), and would be abel to
> supply an answer. The answer and question would then be stored in the
> 'Ruby FAQ'
>
> Personally... that's a _dream come true_ for Ruby.
I really like that idea... FWIW, here are some of my thoughts on the matter
I've always thought that the greatest thing about PHP is it's
documentation. Since users can easily add to the docs, it helps the
maintainers keep things fairly well updated, and offers extra tips and
tricks, right in the docs themselves.
Being able to ask a question and have it notify volunteer documenters
is a great idea :) I would see it as a subscription: If you feel
you've pretty well figured out a library, you could sign up as a
documenter. Any FAQ's submitted would be mailed to all documenters.
Then, in a "google answers" fashion, responses can be submitted until
the question is answered. The best one gets added to the FAQ.
hmmmm... nice :)
cheers
Mark
> -Rich
>
>