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

[Ferenc Szekely]

Dear maemo.org wiki Editors and Readers,

We are in the middle of converting the old documentation to our new Midgard
Content Management System. As part of this activity we have created a tool that
will import the existing wiki pages to Midgard's Markdown [1] syntax. The
documents written by you will be integrated with the other maemo documentation.
So, how-tos will go to a how-to section, tutorials will be placed among
official maemo tutorials. We try to unite the community by integrating your
contributions properly.

In order to retain editing rights you must have a valid garage account.
Unfortunately we are not able to transfer your wiki accounts to garage, but we
will send a reminder to every wiki editors separately. If you have a garage
account already then you don't need to take any action.

I plan to import the current wiki pages during the coming weekend and beginning
of next week. This process can be followed at test.maemo.org. I will inform you
once the import has finished.

We would like to encourage all of you to start using the new pages as soon as
the wiki import has been completed. However the current maemo wiki will be
available for some time, but we will do __no more__ automated page conversion.
We could be radical and disable editing of the old pages, but this may cause
too much harm. We try to add a note to each old page about the transition
though. So please stay tuned.

Cheers,
ferenc

[1] http://daringfireball.net/projects/markdown/
___
maemo-developers mailing list
maemo-developers@maemo.org
https://maemo.org/mailman/listinfo/maemo-developers

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

[Quim Gil]

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.

Quim

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

___
maemo-developers mailing list
maemo-developers@maemo.org
https://maemo.org/mailman/listinfo/maemo-developers