lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Henri Yandell <flame...@gmail.com>
Subject Re: do we need two FAQs?
Date Mon, 20 Dec 2004 21:07:47 GMT
As I unintentionally kicked off the Wiki suggestion, thought I'd offer
an opinion.

My original thought was that a Wiki wouldn't be as nice as the current
ones, but it would be a nice thing if somehow we could have a wiki
back-end with a nicer front-end. I wasn't trying to push for the wiki
though, I mainly wanted to just see if there's a reason for us to try
and get Infra to install some kind of FAQ software at the ASF.

It seems there are three options to try and have the content at the ASF:

1) Use the Wiki. Good for open community maintained FAQs. Looks poor.
2) Put it on the site. I imagine there's something that can take a FAQ
in XML and output a nice website etc. This is good for project
maintained official-FAQ stuff.
3) Get dynamic FAQ software for the ASF (or code it :) ). I'm not sure
if there are good use-cases for such a thing, ie) how many advantages
do the current ones have over 1) and 2).

Blue-sky thoughts,

Hen

On Mon, 20 Dec 2004 11:46:57 -0500, Erik Hatcher
<erik@ehatchersolutions.com> wrote:
> I still view the wiki as the best place for the "FAQ", however it is
> described.  As a committer with far too many "commitments", I'd prefer
> to see a community maintained FAQ rather than one that requires us
> committers to maintain it in source code control.
> 
>         Erik
> 
> On Dec 20, 2004, at 11:23 AM, Otis Gospodnetic wrote:
> 
> > Wikis have their place as information repositories.  It sounds like
> > what you are describing is not a FAQ, though, no?  I'm all for using
> > Lucene Wiki as we are currently using - scratch pad, whiteboard,
> > community tips, etc.  I think the FAQ is a slighly different beast,
> > hence my double-checking with lucene-dev people.
> >
> > I'm still unsure about the best setup, so I'll wait a little longer to
> > hear some more opinions.
> >
> > Otis
> >
> > --- Erik Hatcher <erik@ehatchersolutions.com> wrote:
> >
> >> On Dec 19, 2004, at 8:37 PM, Otis Gospodnetic wrote:
> >>> OK.
> >>> Is this _really_ what everyone's okay with?  I'm asking because
> >> once we
> >>> put the FAQ onto Wiki we:
> >>>
> >>> 1. no longer have authoritative FAQ - anyone can write to the FAQ
> >>> 2. we have to monitor the Wiki FAQ for correctness
> >>> 3. we have no user-friendly GUI/webapp for Q/A formatting, which
> >> makes
> >>> it more of a pain in the ass to contribute
> >>>
> >>> If anyone has any strong opinions, please share them.  If I don't
> >> hear
> >>> anything, I'll (try to) get the jGuru FAQ XML dump and give it to
> >>> Daniel for 'wikification'.
> >>
> >> I prefer to leverage the wiki for this type of information for a
> >> number
> >> of reasons.  It is self-maintaining, not requiring a committer to
> >> take
> >> time out to commit changes and update the website.  We have e-mail
> >> notification of wiki modifications and thus we already have
> >> monitoring.
> >>   There are many cases when using Lucene when the answer is "it
> >> depends"
> >> (such as the filtering question that just came up).  Having a wiki
> >> "whiteboard" for these scenarios allows for a broader perspective.
> >>
> >>      Erik
> >
> >
> >
> > ---------------------------------------------------------------------
> > To unsubscribe, e-mail: lucene-dev-unsubscribe@jakarta.apache.org
> > For additional commands, e-mail: lucene-dev-help@jakarta.apache.org
> 
> ---------------------------------------------------------------------
> To unsubscribe, e-mail: lucene-dev-unsubscribe@jakarta.apache.org
> For additional commands, e-mail: lucene-dev-help@jakarta.apache.org
> 
>

---------------------------------------------------------------------
To unsubscribe, e-mail: lucene-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: lucene-dev-help@jakarta.apache.org


Mime
View raw message