Slashdot Mirror

← Back to Stories (view on slashdot.org)

How To Build And Maintain A Good FAQ

Posted by timothy on from the rare-art dept.

comforteagle writes "FAQs have been around since the beginning of the web & most of them still suck. Most of us who build FAQs rely on handcrafting them, but this really isn't necessary anymore. Sean Kerner has written The FAQs on FAQs as an introduction to getting up to speed fast with a FAQ, letting opensource software do the majority of the work, and allowing the author to concentrate on providing good answers. He shortly reviews a few apps, but settles on phpMyFAQ."

1 of 221 comments (clear)

  1. This is what pisses me off by Donny+Smith · · Score: 0, Offtopic

    This is what pisses me off about the way the current computing works - it's been, what, 20 years that computing has been commoditized and we are still fscking around with things like these.

    And of course it's not only this (actually I'm very interested in this because I'm currently using announcement-type postings and a PHP-based forum software instead of dedicated FAQ pages).
    What has been annoying me since 1992 is that back then I used to screw around with Windows 3.1 config files (remember WinSock/dial-up?) and today's software is not much different - yeah, we have Apt and Yum, but even so I still have to "vi /etc/somefile.conf" at least once a day.

    So I ask: what is going on? And I answer: something is very wrong!
    Will we ever move to the next level?
    Will we ever have self-documenting software?

    And look at these geniuses - http://www.phpmyfaq.de/ - they have no link to their own FAQ on their front page.. :-)