In the press. "The OpenMoko wiki - a tangled pile of mostly outdated and incomplete documentation."

steve steve at openmoko.com
Fri Jul 18 03:09:26 CEST 2008


Organizing the wiki is a monumental task.

My suggestion for the front page was three categories as opposed to your 5

1. Products.
2. Developer resources.
3. Community.

No system will be perfect and no organization of data will suit everyone
since we all carve
The world up in different ways.

That said, I would not object to the 5 categories you suggest.

The biggest issue is the massive amount of knowledge the community generates
about the devices.

This knowledge needs to be structured and disseminated.

Easier said than done.


 

-----Original Message-----
From: Stroller [mailto:stroller at stellar.eclipse.co.uk] 
Sent: Thursday, July 17, 2008 1:19 PM
To: List for Openmoko community discussion
Cc: steve; Brenda Wang
Subject: Re: In the press. "The OpenMoko wiki - a tangled pile of mostly
outdated and incomplete documentation."

Hi there,

I thought to try fixing a small part of this particular problem by editing
the main page & adding a link to http://wiki.openmoko.org/
wiki/Distributions

But I do not see where to put it! Perhaps it should replace the "Current
software stack" link to http://wiki.openmoko.org/wiki/ NeoSoftwareStack ??

Perhaps these 5 categories:
   Introduction to Openmoko
   Openmoko Products
   Join Openmoko development
   Openmoko community
   Getting started with Openmoko Wiki
should be extended with the addition of "Openmoko software"?

Or perhaps I should just get my hands dirty and change the "Introduction to
Openmoko" to include the link to "Distributions"? As a user I feel reluctant
to edit the main page as I feel it "belongs"  
to Openmoko the company or to Brenda, so you must tell me explicitly if you
wish me to feel free.

Stroller.



On 17 Jul 2008, at 20:00, steve wrote:

> Brenda
>
>   The main page index does not address Scotts issue.
>
>   I second scott's criticism of the wiki. It is not organized well.
>
>   A good start would be a better search engine
>
>
>
> Steve
>
> -----Original Message-----
> From: community-bounces at lists.openmoko.org
> [mailto:community-bounces at lists.openmoko.org] On Behalf Of Brenda Wang
> Sent: Thursday, July 17, 2008 6:56 AM
> To: scott at tnstaafl.net; List for Openmoko community discussion
> Subject: Re: In the press. "The OpenMoko wiki - a tangled pile of 
> mostly outdated and incomplete documentation."
>
> Hi, I am wiki full time editor of Openmoko.
> Thank you for your opinion . I will put more effort , to make wiki 
> more easy to use.
> And now , If you want to know what we have on wiki , Please use this 
> Index page.
> http://wiki.openmoko.org/wiki/Main_Page
>
> Brenda
>
> Scott Derrick ??:
>> Perhaps this is what you seek?
>>
>>> http://wiki.openmoko.org/wiki/Distributions
>>>
>>>
>>>
>> This is a great page, one of the gems hidden in the bowels of the OM 
>> Wiki.
>>
>> Its also a great example of whats wrong with the Wiki.
>>
>> But how do I find it?  Its not listed on the home page,  not on the
>> FreeRunner page,  not on the getting started page?    Unless I search
>> for exactly teh right word or combinations of words I would never 
>> know it existed... The only link I could find, after I knew it 
>> existed was Software/distributions/distributions..
>>
>> There has to be some kind of boiler plate format for the design and 
>> layout of the Wiki so things are easier to find. You can't rely on 
>> the search engine, it sucks..
>>
>> I think that was the point of the person who recommended the OpenWRT 
>> Wiki.  Its design and format was easy to use and helped you find 
>> things instead of thwarting you.
>>
>> Scott
>>





More information about the community mailing list