2 ms·
For me biggest issue are synthetic FAQs because they don't really offer anything that documentation would not. Worst offenders are when CEO tells some intern th
by ozim 5y ago
For me biggest issue are synthetic FAQs because they don't really offer anything that documentation would not. Worst offenders are when CEO tells some intern that they need FAQ on the page so that people can see that other people are asking questions about product ;)
Ideal FAQ lets you search or has questions in a way real person would ask, as those should be written down in a way most people asked such questions. We could even have index of multiple forms of the same question pointing to the right answer.
Problem with documentation is that it is not written there to answer questions. It is written from perspective of "how system works" so someone just writes it down.
For technical documentation like a language I don't expect much need for an FAQ because audience should be able to pose questions and answer those by themselves and then search what is provided like a manual.
For web application or government websites that general audience should use I don't see "documentation" approach viable, you need "Questions and Answers" approach.