wiki reorg - Documentation Team

Justin Wong stryderjzw at gmail.com
Wed Jul 23 07:10:27 CEST 2008


Hi,

I'm very interested in helping to reorganize the documentation because
I see the problems that are occurring and I think this is an area that
I will be able to contribute at. I have to agree also, with the point
that we don't want an ad-hoc approach where everyone make changes as
they see fit.

We need a unified approach to diagnose and fix this problem. I think
we need to identify the problems before implementing any solutions.
Otherwise, the solutions implemented might not even solve the
underlying problems.

I'm hoping that we can create a documentation team. Anyone is welcome
to join and I hope to have one representative from the Openmoko team.
(I believe Brenda would be the most suitable candidate?)

The team should meet online on IRC once a week, if possible.
Preferably, there'd be a good time where most people can attend. If
not, there'd have to be other ways to coordinate.

I've created a page for whoever is interested.
http://wiki.openmoko.org/wiki/DocumentationTeam

I hope the dedicated people on this list can work together to solve
the documentation problem.


Thoughts? Ideas? Suggestions?

Cheers!
Justin



On Tue, Jul 22, 2008 at 12:07 AM, Torfinn Ingolfsen <tingox at gmail.com> wrote:
> Hello,
>
> On Tue, Jul 22, 2008 at 2:25 AM, ian douglas <ian.douglas at iandouglas.com> wrote:
>> I'm not sure that an ad-hoc "wild wild west" approach where everyone
>> just updates the pages as they see fit is going to make things any
>> better than they currently are.
>
> I agree - we definately don't want this.
>
>> We should have some sort of idea/guidelines for when it's okay to delete
>> old content or move it to new categories.
>
> Perhaps we should look at and discuss how to update the existing
> guidelines on the wiki?
> http://wiki.openmoko.org/wiki/Openmoko_Wiki_Editing_Guidelines
>
> There is also this page, which at the moment doesn't seem very helpful:
> http://wiki.openmoko.org/wiki/Wiki_pages_that_need_updating
>
> It should at least have timestamps for reporting / fixing issues.
>
> This one looks interesting too:
> http://wiki.openmoko.org/wiki/Wiki_Issues
> --
> Regards,
> Torfinn
>
> _______________________________________________
> documentation mailing list
> documentation at lists.openmoko.org
> https://lists.openmoko.org/mailman/listinfo/documentation
>




More information about the documentation mailing list