request for documentation page and location to put it

Sat Aug 2 08:38:03 CEST 2008

Justin,

You are quite right. The bug tracking system will be fine for this info.

I think it would be useful to have perhaps the most common or perhaps 
most apparent or perhaps most offensive bugs listed on the wiki main 
page, with a pointer to the TRAC item.

I'm having a bit of trouble identifying exactly what problem I'm trying 
to solve and how to solve it. Perhaps you can help:

Look at it from the point of view of a new user (still developer, like 
us, but new to the community). You get the device and charge it up and 
find that your SIM card doesn't work and/or GPS doesn't work or whatever.

Had you been on the mailing list for the past couple of weeks you would 
know exactly what is going on. But you just joined. So you visit the wiki.

Would you expect to find this on the wiki, and, if so, what keywords 
would you expect?

To me, "Known Issues" are the keywords I would look for.

Thoughts?

Michael

Justin Wong wrote:
> Hi Michael,
> 
> Just wondering what the difference between this and a bug tracking
> system would be.
> 
> It sounds like a bug tracking system could maintain all that
> information about "known issues" and would do it in a more efficient
> manner than the wiki.
> 
> So we need to think of is how to link the wiki and the bug tracking
> system together?  Or perhaps no link is necessary and just pointing to
> it is enough.  I don't know.
> 
> As for a place to answer frequent questions, I think the FAQ would be
> a good place, but it needs to be organized in an efficient manner.
> 
> 
> Cheers!
> Justin
> 
> 
> On Fri, Aug 1, 2008 at 7:55 PM, Michael Shiloh <michael at openmoko.org> wrote:
>> Many people come to the wiki when something doesn't work. I've been
>> trying to figure out the best way to help them, and I've come up with
>> this idea. Please tell me what you think:
>>
>> 1. Have a "known issues" section prominently displayed on the main page,
>> perhaps near the top.
>>
>> 2. Each known issue should include the symptoms and a diagnostic (so
>> that a user can determine whether the problem they are experiencing is
>> in fact this known issue). Diagnostics might be sparse when an issue
>> first becomes known, and will become clearer as we learn about the issue.
>>
>> 3. Each known issue will also (hopefully :-) feature a solution section,
>> although initially it might be empty.
>>
>> 4. After a known issue is solved, and the patches are present in daily
>> builds, and enough time has elapsed to prove it is really solved the
>> issue must be removed from the "known issues" section so that the wiki
>> remains uncluttered.
>>
>> This also raises the question of historical items. Once things are over
>> and done, removing from the wiki would avoid confusion. On the other
>> hand, history is good. Not sure how best to handle this, but it's lower
>> priority I think.
>>
>> Michael
>>
>> -------- Original Message --------
>> Subject: FW: Sim card is not working, how do I run diagnostics?
>> Date: Sun, 20 Jul 2008 14:32:02 -0700
>> From: steve <steve at openmoko.com>
>> To: William Lai <will at openmoko.com>,    Neng-Yu Tu (Tony Tu)
>> <tony at openmoko.com>,    Michael Shiloh <michael at openmoko.org>
>> CC: Sean Moss-Pultz <sean at openmoko.com>
>>
>>
>> We need a place where people can go to get this informtion
>>
>> Wiki is NOT good enough
>>
>> Mailing list is a nightmare, like asking the sphinx.
>>
>>
>> -----Original Message-----
>> From: community-bounces at lists.openmoko.org
>> [mailto:community-bounces at lists.openmoko.org] On Behalf Of Adam Talbot
>> Sent: Friday, July 11, 2008 3:23 PM
>> To: List for Openmoko community discussion
>> Subject: Re: Sim card is not working, how do I run diagnostics?
>>
>> And I am stuck
>> I have 3 brand new sim cards.
>> 71234G
>> 71234O
>> 71234D
>> None of which work in my FreeRunner. What does the reading of the SIM?
>> How do I look at that for bugs, and perhaps a bug fix.  What is needed on
>> the SIM, is it just the S/N?  Can I reprogram a S/N for an unactivated card
>> to one of my old working chips? Then call AT&T and get it activated?
>> Any ideas?
>> -Adam
>>
>>
>>
>> On Thu, 2008-07-10 at 22:39 -0700, Adam Talbot wrote:
>>> I am a tinker, left on my own (+google) I can figure out almost
>>> anything :-)
>>>
>>> Sim cards.  Here is the "how to" check.
>>> Follow this until you get an OK prompt.
>>> http://www.openmoko.org/wiki/Manually_using_GSM
>>>
>>> >From there your first command should be at+cimi.  If it returns the
>>>> S/N
>>> of your card, you have a working card.  If not (ERROR), you are out of
>>> luck.
>>> Here are the cards I tested:
>>> AT&T, blue front, purple/blue-green back.   Worked.
>>> AT&T, All white. Worked.
>>> Cingular, 73000O (4021)  Worked.
>>> Cingular, 63512A (1002)  Worked.  FR hung on boot, may be unrelated.
>>> Reboot fixed it.
>>> AT&T, 71234G (3022)  I have two, both failed.
>>> Should there be a global SIM card compatibility section? Like this,
>>> just MUCH bigger?
>>> http://www.openmoko.org/wiki/Carriers/ATT
>>>
>>> I am running a Freerunner +
>>>
>> Openmoko-openmoko-devel-image-glibc-ipk-P1-Snapshot-20080710-om-gta02.rootfs
>> .jffs2, my provider is AT&T, out of California.
>>> Hope this helps.
>>> -Adam
>>>
>>>
>>> http://www.openmoko.org/wiki/Manually_using_GSM
>>> On Thu, 2008-07-10 at 19:59 -0700, Adam Talbot wrote:
>>>> My sim card is not working, how do I run diagnostics? I was looking
>>>> on the Wiki, but searching for sim turns up nothing worth while.  I
>>>> have a pile of sim card to work with, each different.  Would love to
>>>> test them out.  Where is the "how to"?
>>>> -Adam
>>>>
>>>
>>> _______________________________________________
>>> Openmoko community mailing list
>>> community at lists.openmoko.org
>>> http://lists.openmoko.org/mailman/listinfo/community
>>
>> _______________________________________________
>> Openmoko community mailing list
>> community at lists.openmoko.org
>> http://lists.openmoko.org/mailman/listinfo/community
>>
>>
>> _______________________________________________
>> documentation mailing list
>> documentation at lists.openmoko.org
>> https://lists.openmoko.org/mailman/listinfo/documentation
>>