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
[email protected]
http://www.lispniks.com/mailman/listinfo/gardeners
