Groupe Ubuntu-fr documentation

Notre documentation est un wiki collaboratif auquel tout le monde est donc invité à contribuer. 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 encourage la participation des nouveaux contributeurs, et s'assure que son contenu, en évolution constante, reste conforme à la ligne éditoriale, au code de conduite et respecte les modèles préconisés afin de garder une documentation homogène. Elle est organisée en trois groupes qui vont être détaillés ci-après.

C'est vous.

Dès que vous créez ou modifiez une page vous devenez contributeur de la documentation. Vous êtes un des éléments essentiels au bon fonctionnement de la documentation francophone. Les contributions sont ouvertes à tous, mais pensez tout de même à vous connecter afin que nous puissions suivre plus facilement vos activités.

Les différents contributeurs peuvent coordonner leurs efforts grâce à la liste de discussion, en écrivant à l'adresse wiki [AROBASE] ubuntu-fr.org où vous pouvez proposer des idées, signaler la création de nouvelles pages, des modifications importantes ou des erreurs, et surtout être aidé dans vos premières contributions.

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.
• Organiser 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 comme par exemple en surveillant le forum et remontant à 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 Expert Wiki.
• En plus de faire joli, ce titre leur donnera accès à certains outils avancés du wiki comme le gestionnaire de réversion¹⁾.
• Ils ont accès à la mailing list de coordination avec l'équipe des 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 avoir ainsi accès aux outils correspondants.

L'intégration au groupe des contributeurs experts 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.

Aujourd'hui ce groupe est composé de:

• Bcag2
• Draco

De même que les contributeurs experts, 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 : il est possible de cumuler les deux rôles mais en règle générale ce n'est pas le cas.

Il intervient dans de nombreux domaines :

• 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. Les administrateurs partagent avec les contributeurs experts une mailing-list propre à la coordination du wiki, et ils ont de plus accès à un panel élargi d'outils pour superviser l'activité de la doc. Ils ne sont pas forcément très actifs sur la liste de diffusion et le wiki car comme tout le monde, ils font ça sur leur temps libre et doivent répartir leur temps en fonction des priorités.

Les administrateurs actuels de la documentation sont :

• Aldian
• Fabux
• YoBoY

Les conditions sont les mêmes que pour devenir un contributeur expert : Avoir un minimum d'ancienneté et s'être fait remarquer par la qualité de ses contributions. Nul besoin en revanche d'être hyper calé sur Ubuntu ou sur l'administration système. Il faut simplement aimer partager ses passions, avoir un minimum de temps libre pour pouvoir assurer un suivi régulier, et savoir se montrer patient, compréhensif et pédagogue.

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 général et des 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.

Tout le monde peut devenir administrateur système de la doc. Si cela vous intéresse, parlez-en aux admins de la doc ou rejoignez le Groupe des développeurs des applications web.

Les administrateurs de la documentation