request for documentation page and location to put it

Justin Wong stryderjzw at gmail.com
Sat Aug 2 22:27:35 CEST 2008


Hi Michael,

Yes, definitely from what I can see currently, the wiki would be the
first place I'd look if I was in that scenario.

"Known issues" are good keywords to look for.  Perhaps we can
transform the "Getting Started FAQ" by renaming it "Known Issues".  It
seems like that the "Getting Started FAQ" is trying serve the known
issues purpose.

Cheers!
Justin


On Fri, Aug 1, 2008 at 11:38 PM, Michael Shiloh <michael at openmoko.org> wrote:
> 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
>>>
>




More information about the documentation mailing list