Hacker News new | ask | show | jobs
by eitland 1286 days ago
> "well-stocked FAQ"

Do you have examples?

When I think of FAQs, IIRC almost all the time it seems like they wrote it before release and never upgraded it with actual questions.

2 comments

NearlyFreeSpeech has an incredible FAQ: https://www.nearlyfreespeech.net/about/faq
From the other side of the fence - you can base your FAQs on actual questions (to the point of highlighting and bolding the most common) only to keep getting a significant amount of requests with that exact same question multiple times a day.
Absolutely.

But in most cases I think it is both: FAQ isn't updated/relevant && people don't check it.

I can confirm that - at least in my experience - FAQ's are pre-made (and never or rarely updated), when a new service/site/whatever starts, it is logically nonsense that there is even one FAQ.

In theory everything should be clear from the info/documentation/manual, and when it is not so (as it often happens) and something is actually frequently asked, not only an entry in the FAQ list should be added (together with its FGA[0]) but the sheer fact that it is frequently asked should mean that the topic is not clear enough in the info/docs/etc and these should also actually be corrected/updated.

As a "disciplined" user (who actually did read both the FAQ's and the documentation) when you (manage to) contact (via mail/chat or phone) the assistance with a question/doubt there are usually three possibilities:

1) the assistant knows less than you on the topic and cannot answer properly

2) the assistant is competent and manages to answer your question, though with some difficulty (you made an original question)

3) the assistant is competent and answers your question easily because it has already been answered by him/her tens or hundreds of times (your question was not so original but never made it to the published FAQ's)

#3 is the clear sign of a failure in the way FAQ's are managed.

[0] http://jdebp.info/FGA/fga-not-faq.html

> Acronym for "frequently asked questions"; a list of answers to frequently asked questions that can be presented to a community (be it a forum, Usenet newsgroup, or software user base) so that the same questions need not be asked over and over again. In the entire history of their use, not one has ever been used for its intended purpose.

From the BonqQuest glossary https://www.jerkcity.com/glossary.html