[maemo-developers] [maemo-developers] important message for maemo.org wiki users

From: Quim Gil quim.gil at nokia.com
Date: Fri Feb 16 10:14:24 EET 2007
There is this still too abstract idea of tagging doc pages with status
i.e. "unreviewed draft", "official doc", "works for me" etc. Those tags
could be assigned either at an official level (to distinguish supported
docs from those not officially supported) or at a community level (to
distinguish good/useful documentation from the rest).

The use case of one maemo admin tagging a doc as official has no
mystery. Then we would have some community based use cases with some
more planning complexity i.e.:

- 32 identified users say this unofficial doc just works as expected,
while 4 say it needs improvement and 0 tagged it as buggy. I would trust
the content of this page, specially if the "last update" was made three
weeks ago.

- 17 identified users say this official doc is in fact outdated. I would
probably trust them.

- 14 users have tagged this doc as "experimental - use at your own
risk". I probably will leave it for tomorrow.

And so on.

In fact I'm waiting that documentation manager to be hired to start
throwing ideas on her.  :)  I think the tagging system would help a lot
getting more and better documentation, with an easy started point ("I
have done this thing in this way, try it") and a capacity to evolve
documents tagging its status until they become either official or widely
supported by the community editors.

In my opinion this is much better than setting two separate sources of
documentation, and having to move docs from source to the other as soon
as they get mature/outdated if you want to keep both sources healthy.

In fact this is what Wikipedia does with the "This article is a stub"
statement, originator of this idea.


On Thu, 2007-02-15 at 16:29 +0200, ext Ferenc Szekely wrote:
> Having a "staging" or "experimental" area for such docs is a very good
> idea

More information about the maemo-developers mailing list