Contenu | Rechercher | Menus

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.

Les Contributeurs

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.

Pour plus d'informations sur comment contribuer, consulter la page Comment participer et améliorer cette documentation ?

Les Contributeurs chevronnés

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.

Leur(s) rôle(s)

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.

Leurs privilèges

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 avoir ainsi accès aux outils correspondants.

Comment rejoindre l'équipe

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.

Le groupe des contributeurs chevronnés a été créé à la suite de la réunion du 26 juin 2017. Il est encore en construction et la description précédente reste susceptible de changer en fonction des retours de ses membres.

Administrateur

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.

L'administrateur de la doc

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 1) depuis son navigateur internet ou son client mail.

Tout comme les contributeurs chevronnés, les administrateurs possèdent une mailing list qui leur est propre et ils ont 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. Aujourd'hui l'équipe des administrateurs de la documentation est visible ici.

Devenir administrateur

Les conditions sont les mêmes que pour devenir un contributeur chevronné: 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 et savoir se montrer patient, compréhensif et pédagogue.

L'administrateur système de la doc

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

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

1)
Interface Homme-Machine


Le contenu de ce wiki est sous licence : CC BY-SA v3.0