Contenu | Rechercher | Menus

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.

Les Contributeurs

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.

Coordination

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.

En cas de difficultés et/ou de désaccord, veuillez vous référer aux administrateurs de la documentation.

Les Contributeurs experts

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) activité(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.
  • 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.

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 Expert Wiki.
  • En plus de faire joli, ce titre leur donnera accès à certains outils avancés du wiki comme le gestionnaire de réversion1).
  • 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.

Comment rejoindre l'équipe

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:

Le groupe des contributeurs experts 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.

Les Administrateurs

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.

L'administrateur de la doc

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 IHM2) 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 :

Devenir administrateur

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.

On peut joindre l'équipe des administrateurs de la doc par courriel à l'adresse suivante : admins-doc [AROBASE] listes.ubuntu-fr.org

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 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.

Quelques chiffres

Statistiques des modifications de pages

Diagramme des contribution de 2007 à 2010

2008 2009 2010 2011 2012 2013 2014 2015 2016
Janvier 3882 4908 3833 2795 1794 1676 1211 959 1106
Février 3595 3133 3195 2059 1506 1364 1184 817 1532
Mars 4295 3274 2464 1802 1693 1435 1025 1193 1502
Avril 3837 3397 2731 1982 1568 1206 1134 755 1187
Mai 4394 3669 3291 2595 2188 1239 1101 840 1790
Juin 4029 2630 2068 2044 1358 1028 1104 619 1285
Juillet 3304 4070 2891 1693 1761 1174 1070 511 580
Août 3143 3350 2818 2105 1173 1160 753 1141 759
Septembre 3545 3304 3219 1484 1223 849 703 817 897
Octobre 3806 4932 3474 1626 1538 1260 970 946 700
Novembre 4442 5349 3288 2036 1777 922 984 990 757
Décembre 4220 3862 2820 2548 1455 866 768 1217 1036
Totaux 46492 45878 36092 24769 19034 14179 12007 10805 13131
Pages 3574 4555 4549 3742 2889 2338 2200 2211 2940
Nouvelles 1549 1569 1524 1089 464 299 294 286 200
Identifiés 1650 1246 1348 1246 961 792 652 545 494
Anonymes 23618 22487 13467 11342 8177 6191 4721 4071 5315

Les administrateurs de la documentation

1)
Outil permettant de lutter contre le vandalisme
2)
Interface Homme-Machine


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