Hi,

Just to sound a word of caution here.

Although FAQs are extremely popular, they are also dangerous because
the bigger a FAQ gets, then the more it will overlap and repeat
material repeated elsewhere in a more structured way. Also, the bigger
it gets, the less of an effective FAQ it is, because it will start to
deal with questions that are not "frequently asked".

There are already at least three different "forms" of documentation
for local teams:

1. https://wiki.ubuntu.com/LoCoFAQ
2. https://wiki.ubuntu.com/LoCoTeamHowto
3. https://wiki.ubuntu.com/LoCoTeamKnowledgeBase

In my view, it's generally more efficient and useful for people
reading to have documents structured by subject matter, rather than
having different forms of document which may well end up repeating the
same information. It's quite difficult to keep three separate
different information sources up to date when something changes.

I think the third page in the above list is the most useful because it
breaks information down into different types of material, and a reader
can easily see which bit is relevant to his/her particular question or
interest.

I'm not saying there shouldn't be a page listing frequently asked
questions because I can see the use in a document that lists questions
which are genuinely common, for quick perusal, but I don't think that
it should be the definitive source of information, or that it should
be updated ahead of other pages that exist in the knowledge base.

Matt

-- 
loco-contacts mailing list
[email protected]
https://lists.ubuntu.com/mailman/listinfo/loco-contacts

Reply via email to