Re: lisp FAQ status
Agreed -- they both look great!
Honestly, I suspect that the wiki one is a better idea because
anything that requires continuous maintence is problematic. If you
get busy, lose interest, etc, the wiki will still be a useful resource
that others could update with minimal effort on you part, whereas the
faq one will require lots of your time.
One question you should investigate is how prone both are to
vandalism. That's pretty annoying.
Thanks for the work so far,
Alex
On Tue, Oct 21, 2008 at 12:54 AM, Chris Smith <maximinus@...> wrote:
> They both look fine. Since you've gone to the trouble of setting up both,
> I'm happy to go with your recommendation. I do like the idea of having a
> discussion page though.
>
> Tonight I'll try adding some content to both and give you some more
> feedback.
>
> Chris
>
> 2008/10/21 Pedro Kröger <kroger.lists@...>
>>
>> Hi guys,
>>
>> (I'm sorry I took longer than I said I would, but I had to update my
>> server before I did any work on the faq.)
>>
>> I tested ikiwiki [1] and phpmyfaq [2] as two potential technologies to
>> store the lisp FAQ. As a preview of each tool, I put two "mock" lisp
>> FAQs [3] available on my server, one using ikiwiki:
>>
>> http://genos.mus.br/lispfaq/
>>
>> and the other using phpmyfaq:
>>
>> http://genos.mus.br/lispfaq2/
>>
>> feel free to play with them.
>>
>> here is my list of pros and cons for ikiwiki:
>>
>> * pros
>> - can be edited on-line (just like a wiki) and off-line (it uses git)
>> - simple and clean
>> - uses a "standard" format (markdown)
>> - very css friendly (all visual things can be changed)
>> - has a page for discussion (like wikipedia)
>> - distributed: each git clone is a full repo of the wiki. If I decide
>> to go nuts and live in the Bahamas (not a bad idea) the lisp faq can
>> be easily set up by anyone with a git clone
>>
>> * cons
>> - not really a faq manager
>> - has no top 10 list or rating system
>>
>> here is my list of pros and cons for myphpfaq:
>>
>> * pros
>> - professional feel (whatever that means)
>> - user can ask questions without signing in
>> - bells and whistles: top 10 lists, rating, last five questions, etc
>> - translation system (want a faq in Latvian?)
>>
>> * cons
>> - too complex (bureaucratic) to admin. each faq item has to be
>> approved by the admin
>> - too bondage and discipline (grab your whip, kwaa-tissshhh!)
>> - centralized: the whole thing is in a mysql database. what if I go to
>> the Bahamas and forget to backup?
>> - no "standard" format
>>
>> My personal choice is ikiwiki. I really love being able to edit pages
>> off-line with emacs (git push updates the wiki automagically). OTOH,
>> maybe phpmyfaq will be easier for beginners. What do you think?
>>
>> (I collected all lisp-related questions I could find in a gigantic
>> org-mode file and I'm ready to populate the new-new-new-new faq)
>>
>> Pedro
>>
>> Footnotes:
>> [1] http://ikiwiki.info/
>>
>> [2] http://www.phpmyfaq.de/
>>
>> [3] just a few questions on each faq so you can get the flavor for each
>> system
>>
>> --
>> GNU/Linux user: 77786
>> GPG ID: 8749A953
>> http://kroger.lisp-br.org/index-en.html
>> _______________________________________________
>> Gardeners mailing list
>> Gardeners@...
>> http://www.lispniks.com/mailman/listinfo/gardeners
>
>
> _______________________________________________
> Gardeners mailing list
> Gardeners@...
> http://www.lispniks.com/mailman/listinfo/gardeners
>
>
RSS Feed