L'équipe de la doc

Le principe d'un wiki collaboratif, c'est que tout le monde y contribue. Le simple fait d'en lire une page fait de vous un membre de notre communauté, car vous allez pouvoir mettre en pratique ce que vous y apprendrez, enrichir les pages au gré de vos découvertes, et remonter à l'équipe les éventuels problèmes rencontrés dans la compréhension des pages.

L'équipe qui gère la documentation est organisée en trois groupes qui vont être détaillés maintenant.

A partir du moment où vous avez un jour modifié une coquille dans la doc ou interagi avec l'équipe vous en devenez un. C'est donc un groupe très vaste, qui rempli de très nombreuses tâches sur la documentations, chacun selon ses capacités.

• Ca peut être pour des interventions rapides et ponctuelles, par exemple une modification de lien mort ou d'une mise en forme, un ajout d'informations sur une compatibilité matérielle, la correction de fautes d'orthographes, la mise à jour des tags d'une page qu'on vient de tester sous une version plus récente, etc.
• Ou dans certains cas pour des interventions plus conséquentes comme la création de page sur de nouvelles applications, un nouveau tutoriel, une nouvelle variante d'Ubuntu, ou encore la refonte d'une page ancienne, ou la participation à l'un des nombreux chantiers du wiki.

Dans le deuxième cas il vous est demandé de rejoindre le groupe des contributeurs qui se coordonnent via la mailing list et le salon de discussion du wiki.

Ce sont des contributeurs comme les autres, mais qui ont une bonne expérience de la documentation et des règles d'édition et qui sont reconnus pour la qualité de leurs contributions.

Ils font la même chose que la plupart des contributeurs, mais ils sont plus spécifiquement invités à intervenir sur un ou plusieurs des points suivants, en fonction du temps qu'ils peuvent y consacrer et de leurs envies:

• Apporter leur aide aux nouveaux contributeurs en répondant à leurs questions et en les aidant à comprendre les règles du wiki.
• Suivre les chantiers récurrents du wiki, y participer, y sensibiliser les autres contributeurs.
• Faire le lien entre liste de diffusion, salon de discussion et forum et en particulier surveiller le forum et remonter à la liste de diffusion les sujets wiki qui y sont débattus.
• Participer à l'animation de nos outils de communication en répondant aux questions courantes et en attirant l'attention des administrateurs sur les questions épineuses.

Quelques outils sont mis à leur disposition pour les aider dans leurs tâches:

• Au niveau du forum, le titre visible sur leur profil ne sera plus Membre, mais ContributeurChevronne.
• En plus de faire joli, ce titre leur donnera accès à certains outils avancés du wiki comme le gestionnaire de réversion.
• Une mailing list dédiée à l'équipe est mise à leur disposition pour se coordonner entre eux et avec les admins
• Au cas par cas, sur la base du volontariat et de l'ancienneté, ils peuvent se voir initiés à une partie du travail des admins, et se voir donner l'accès aux outils correspondants.

L'intégration au groupe des contributeurs chevronnés peut se faire suite à une candidature spontanée auprès de l'équipe des admins ou sur proposition de ces derniers. Les conditions sont les suivantes: six mois d'ancienneté sur la doc et s'être distingué par la qualité de ses contributions.

De même que les contributeurs chevronnés, les administrateurs sont avant tout des contributeurs. Mais avec des pouvoirs et des responsabilités supplémentaires.

Il ne faut pas confondre administrateur de la doc et administrateur système: en effet il est possible de cumuler les deux rôles mais en règle générale ce n'est pas le cas.

Il rend de nombreux services à la communauté, par exemple en s'assurant que la doc soit pérenne à long terme, en coordonnant les chantiers récurrents qui permettent notamment la mise à jour continue de la doc, en proposant les évolutions qui peuvent sembler nécessaires en fonction des besoins actuels, et en veillant à l'homogénéité et la lisibilité de la doc. Il n'a pas d'accès physique ou SSH aux serveurs: tout son travail se fait via les IHM ¹⁾ depuis son navigateur internet ou son client mail.

Il n'a pas forcément accès aux machines (à moins de faire également partie de l'équipe d'infra), mais il s'intéresse pour sa part aux problématiques de maintenance et d'évolution du code source de la doc, ce qui inclut par exemple le test des mises à jour de php, le test des mises à jour de dokuwiki, l'évolution si nécessaire du template et de styles de la documentation, le test des plugins qui pourraient être ajoutés et la participation à certains chantiers comme l'export de la doc pour une consultation hors ligne