wiki reorg - Documentation Team

[Justin Wong]

Hey Stroller,

I did read most of the emails on this list and, although it's a bit
unrealistic to answer every question, I will try my best to give some
opinions on the matters.

- what do you think of the content on the Main Page?
The Main Page should have as few "content" as possible. See below
answers for what I mean.

- is it suitable for people visiting the Openmoko Wiki for the first time?
I'd say, no. There's an overwhelming amount of stuff on the main page.
I believe the theme of Main Page should be simplicity and it gets
people to other pages.

- should it be? Or should it be suitable for everyone visiting the
Openmoko Wiki, even if they've visited before?
It's hard to answer this question without identifying the main groups
of users of the wiki. Presumably, there are people new to Openmoko
(without any previous knowledge), and then there are veteran core
developers. Perhaps there are more categories of people. But these are
my assumptions without doing any actual research.

The wiki and documentation should work for all these people. We
shouldn't cast anyone out.

- whatever else you think of the content on the Main Page.
Please see the first question.

I must say, though, that with a team of any significant size, we'll
unlikely be getting consensus on every matter. What happens then?

I see quite a bit of work going into the wiki right now, but how does
this work fit into the overall big picture plans to fix the
documentation?  Is this bigger picture written down somewhere so wiki
maintainers know what they're doing is right or is there currently
only a list of "random" tasks to accomplish? Example, how do we know
we need a FAQ? Who is the FAQ targeted towards?

For sure, I see a lot of good things happening!  I'm just a little
apprehensive about whether all of the work is in the direction.
Perhaps I'm just missing the document that shows the research and
decisions before actual work takes place.

I'd love to hear back on thoughts and opinions.

Cheers!
Justin



On Thu, Jul 24, 2008 at 2:53 AM, Stroller
<stroller at stellar.eclipse.co.uk> wrote:
>
> On 24 Jul 2008, at 10:44, Stroller wrote:
>> On 24 Jul 2008, at 06:57, Justin Wong wrote:
>>> ...
>>> However, I am seeing many individual efforts and not much effort as a
>>> team. If we continue to work the way things are going currently, not
>>> only are we going to get duplicated and wasteful work, but our
>>> efforts
>>> will also be fragmented and possibly going in different directions.
>>
>> That's what this list is for.
>>
>> Could you please respond to existing requests for comments already
>> posted on this list in the last few days.
>> ...
>>
>> Please start with the first post to this list, read every one, and
>> reply to every message in which the author has requested your
>> opinion (assuming you have one to give).
>
> Sorry! Meant to include this URL:
> http://lists.openmoko.org/pipermail/documentation/2008-July/thread.html
>
> I could perhaps also have highlighted my previous question:
> - what do you think of the content on the Main Page?
> - is it suitable for people visiting the Openmoko Wiki for the first
> time?
> - should it be? Or should it be suitable for everyone visiting the
> Openmoko Wiki, even if they've visited before?
> - whatever else you think of the content on the Main Page.
>
> Stroller.
>
>
> _______________________________________________
> documentation mailing list
> documentation at lists.openmoko.org
> https://lists.openmoko.org/mailman/listinfo/documentation
>