From Mageia wiki
Revision as of 22:04, 5 March 2015 by Franktremblay (talk | contribs) (Members)
Jump to: navigation, search

For an overview, look at Documentation Team Portal

Cette page est également disponible en français
Diese Seite ist auch in deutsch verfügbar.

How to contact/join the team

To contact the Documentation team, you may use the following methods:

  • Mailing-list: doc-discuss@ml.mageia.org.
    • Please make sure you're a member of that mailing list if you're a member of documentation team
  • IRC channel: #mageia-doc on Freenode.
  • Team meetings: 21.00h CET/CEST every other week (the uneven ones) on #mageia-doc
  • Team contact: Lebarhon - lebarhon AT free DOT fr
  • Leaders
    • Yves Brungard (papoteur) - yves DOT brungard UNDERSCORE mageia AT gadz DOT org
    • A.M. Desmottes (lebarhon) - lebarhon AT free DOT fr

To join the Documentation team, you only have to put your name on the list below, sign up to the mailing list and say 'Hi!'. We would also be happy if you could attend the team meetings (see third item in the list above).

Documentation process

Documentation team responsibilities

The documentation team has two main purposes:

  • The team is in charge of the end-user documentation in the wiki (the web team being in charge of the structure). We should also oversight the content from other teams (since most teams will have a dedicated area in the wiki) to make sure the wiki stays coherent and clean.
  • We should also produce an official end-user documentation to be included in Mageia releases.

Current work

The documentation team is still looking for more members. If you think you can contribute in any way, please join us on the mailing list and say hello!

The most important topics of our work are (click on the title to have more details):

  • the installer help: when installing Mageia, an inline help can be accessed. It's our work to build it and to maintain it. The work was done for Mageia 2, and we have yet to adapt them for new versions, in particular with new screen shots. We hope also that more translations will be available. The help is also available on-line [1].
  • the Mageia Control Centre help: Mageia use specific tools to configure it. We documented most of them, but not all. The documentation will be also available inline with Mageia and further and is already accessible online. We need to complete with the missing help, and to translate in more languages.

For these two topics, we use a tool called Calenco, in which the documents are written in Docbook format. Each page is a file which can be edited with an text editor or an XML editor like XXE. There is no need to have a deep experience with docbook, but some precautions must be taken to keep a regular format.

  • the wiki: the Doc Team is currently working on making sure the Wiki is well structured without redundant pages. The syntax for the wiki is simple. You can contribute by writing pages, checking and updating already written pages or by proposing subjects to develop. Pages can be started by anyone who is registered. This page expose the method to work on wiki and some topics that we hope to be written.

Members

Please add yourself to this list if you are willing to contribute to the documentation team. If it is possible, please write your Nick (Mageia username [the one your registered on identity.mageia.org ]), name, e-mail address and what you want to do in the team. Please do this in alphabetical order by the nick. Thx!

Mageia Username Other Name Email Address About Mother tongue
Akien Rémi Verschelde remi AT verschelde DOT fr Link with i18n teams, wiki contact, doc writing and proofreading. French
anditalisman Andi Hary Akbar andi[dot]talisman[at]gmail[dot]com doc wiki writing/maintaining Indonesian translations. I'm a newbie
andre999 André Blais andre999mga ad laposte dot net Packaging team contact French
annew Anne Wilson annew AT kde DOT org general help with English pages and use of Translate wiki extension English
Ard1t Ardit Dani ardit [dot] dani AT gmail [dot] com Albanian Translation
crantila Christopher Antila crantila AT fedoraproject DOT org Hmm...
Carluchox Carlos Reges kerg23 AT gmail DOT com Spanish proofreading, writing and correct Spanish
Disa Erik Henriquez erikh1941 AT gmail DOT com English and Spanish proofreading/writing/translating
doktor5000 Florian Hubold doktor5000 AT arcor DOT de MAQeia (Most Asked Questions), Packaging Team contact, german proofreading German
Dune Eric Barbero dune06 AT free DOT fr documentation writing and translation (en > fr) French
dvgevers; dvg Dick Gevers dvgevers AT xs4all DOT nl proofread/correct English wiki, manpage, help etc., could assist in translating some stuff: fluent command of Dutch, reasonable in Fr & De, slight: Es English
esperanto Pablo Foche pablo DOT foche AT gmail DOT com Esperanto translator
franktremblay François Tremblay fmtremblay89 AT gmail DOT com English <-> French translation and proofreading French
JohnR John Rye john At neodoc DOT biz English proofreading and writing English
Kernewes Carolyn Rowse (isolde) cmrisolde AT gmx DOT com English proofreading and writing, could possibly help with German and Swedish proofreading English
Kristien Christian Bonnissol christian DOT bonnissol AT icloud DOT com French native. Documentation writing and translating. French
Hman Armando Basile armando AT integrazioneweb DOT com packaging, maintaining, wiki Italian
Lebarhon AM Desmottes lebarhon AT free DOT fr team leader doc writing/translation(en-fr)/proofreading French
Led43 John Bowden led43john AT googlemail DOTcom Uk resident long term mandrake, mageia tinkerer, help here and on QA
lucas Lucas Borges lucaspatis AT gmail DOT com Pt-BR translator
marja Marja van Waes marja11 AT xs4all DOT nl Calenco documentation Dutch
markhobley Mark Hobley markhobley @ yahoo.donottypethisbit.co.uk wiki,man pages English
MrsB Claire Robinson (claire) eeeemail AT gmail DOT com QA Team Documentation English
msiyer Mohan Sreekant Iyer msiyer AT hotmail DOT com contributor
neggwada Mehdi Hadjard hmehdia at 9online dot fr doc writing/translation/proofreading (en-fr) French
obgr_seneca Oliver Burger oliver.bgr AT gmail DOT com i18n contact German
ocelot-sloth Mark Stenglein ocelotsloth AT gmail DOT com document writing, proofreading (en-us)
osifa Firat Kutlu firatkutlu AT gmail DOT com Turkish Mageia wiki, translator Turkish
phasma Martin Tee martin DOT tee77 AT gmail DOT com Fluent in English, French and Danish. Proofreading and documentation writing also available
papoteur Yves team leader, French native. Documentation writing and translating. French
reidcardwell Reid Cardwell reidcardwell AT gmail DOT com English writing, editing, proofreading
sebsebseb Sebastian
simonnzg Simon Parsons simonnzg AT gmail DOT com EN-GB Technical Editor, mediawiki and XML English
snevog George V jorgosv AT gmail DOT com
stblack Stefano Negro stblack AT gmail DOT com Italian translator, help here and on QA Italian
swecarp Mårten Ström mageiasv@gmail.com Swedish translator Swedish
trinux Tristan Campbell tristan.b.campbell AT gmail DOT com English proofreading, editing, writing English
Umeaboy Kristoffer Grundström kristoffer DOT grundstrom1983 AT gmail DOT com Swedish translator of official Mageia docs swedish
Workaholic Norbert Marchl norbert DOT marchl AT aon DOT at utility man for translations to german (and if possible to cover up doctor5000 with work :) ) German
Xboxboy Xboxboy xboxboy.mageia AT gmail.com English proofreading, editing, writing English



Initial list of registered people (probably outdated since most entries date from the original fork announcement)