[maemo-community] The role of the docmaster

[From: Andrew Flegg]

On Sat, May 16, 2009 at 01:54, Qole <qole.tablet at gmail.com> wrote:
>
> I personally wish there was some way to pull the many, many great tips and
> tricks out of Talk, like a prospector hunting for gold, and collect them
> somewhere central. Too much for one person, but a good organizer /
> delegator could send out teams to rove through the threads and return with
> the nuggets...

Agreed. However:

> For instance, there are great tips for setting up an ssh socks5 proxy,
> trying out the Fremantle interface on your N810, using a bluetooth mouse on
> your tablet, encoding DVDs for best playback, printing from the tablet,
> connecting to passworded Windows shares, streaming video from the tablet
> with VLC, etc, etc...

One of these examples, though, is just using a standard tool (SSH) for
an intended usage; we should be careful that any such repository of
information is well organised and ruthlessly maintained/culled in the
wiki - but that it doesn't end up just being a reference guide to all
the tools available on *any* Linux.

Or should it? My gut says no, but perhaps there are some use cases
that are so commonly encountered that some of this "generic"
information is included.

Quim wrote:
>
> Yet documentation is far from ideal in the Maemo project. Good
> documentation for develope and contributors is an essential part of the
> maturity and success of a project. Although there are many excellent
> undocumented projects that defy this principle, the Maemo project
> decided that it was idea to fund a community docmaster.

Having the docmaster proactively improve the documentation, in the
same way that the debmaster proactively improves packages sounds
excellent; as well as responding to specific problems and long-term
goals.

Of course, that doesn't mean that Dave can't do the other tasks he's
interested in as well (running elections and what not), but clearly
establishing a primary focus on "documentation" would be a Good
Thing[TM] IMHO.

Cheers,

Andrew

-- 
Andrew Flegg -- mailto:andrew at bleb.org  |  http://www.bleb.org/
Maemo Community Council chair