Categories.

Stroller stroller at stellar.eclipse.co.uk
Wed Jul 23 03:27:13 CEST 2008


On 22 Jul 2008, at 21:11, Ferenc Veres wrote:
>>>> Per my last Email about organizing the categories, etc., your new
>>>> "getting started FAQ" should also be put in the FAQ and Freerunner
>>>> categories, right?
>>> I have added to the FAQ category [1]  ...
>>> [1] http://wiki.openmoko.org/wiki/Category:FAQ
>
> I am a bit worried about having several FAQ pages. Well, the  
> project may
> possibly be so large, that it needs a spearate SW and HW FAQ, I am  
> still
> not 100% convienced.
>
> Jacob Nielsen about FAQ:
>
> - Too many websites have FAQs that list questions the company wished
> users would ask.
>
> - They must be reserved for frequently asked questions, since  
> that's the
> only thing that makes a FAQ a useful website feature.
>
> (More on http://www.useit.com/alertbox/20021223.html )

Hi there,

I'll take your point, as long as the single FAQ is readable,  
interesting & useful. IMO it isn't at present.

IMO it's worth differentiating between:
- "I'm having problems doing X with the software installed on the  
latest ASU build"
and
- "Will WINE run on Openmoko?"
- "Is there a MAME emulator available for Freerunner?"
- "Is application X being ported?"

Perhaps this can be done by removing excess cruft from the FAQ,  
having it on a single page and breaking the FAQ into categories. But  
you can see that the latter questions would make good candidates for  
a software FAQ.

>> Looking at this page it's not immediately obvious what the MFAQ & SH1
>> FAQs are. The category page is, however, automatically generated, so
>> it's not possible to change the links to, for instance [[MFAQ|
>> Misinformation FAQ]].
>
> That MFAQ, well, it's great that Doug notified an article editor  
> about a
> letter-case mistake in 2007, but please, don't reserve 3 pages on WIKI
> for keeping track of this.

You're right - I didn't look at this so closely.

I do love the idea of a misinformation FAQ, though, having spent a  
lot of time making rebuttal posts on Reddit, when this video was  
posted there: http://www.vimeo.com/1366042

Maybe we should keep the misinformation FAQ for a while, see if there  
is further need for it and perhaps change its format to a regular FAQ  
Q&A? "Is the Freerunner an iPhone killer?" (or "Why isn't the  
Freerunner an iPhone killer?") would perhaps be an immediate candidate.

Stroller.





More information about the documentation mailing list