Le projet UtilitR
vise à produire une documentation collaborative sur R
, destinée principalement aux agents de l'Insee. C'est pourquoi elle a été élaborée en prenant en compte le contexte de travail propre à l'institut. Cette documentation peut également contenir des éléments pertinents pour un usage de R
en dehors de l'Insee, mais ce n'est pas sa finalité première.
Ce projet trouve ses racines dans la période de confinement qui a touché la France au printemps 2020, et qui a affecté le travail des agents de l'Insee comme de beaucoup d'autres travailleurs. Il est surtout porté par la volonté de tirer le meilleur parti d'une situation difficile, en cherchant à préparer l'avenir et à favoriser des mouvements de solidarité et de bienveillance au sein de l'institut - dans un cadre bien précis et essentiel pour l'institut, celui de l'usage accru de R
dans les missions quotidiennes des agents de l'Insee.
Le projet UtilitR
part du constat qu'il est difficile d'apprendre à utiliser R
pour de multiples raisons: multiplicité de packages faisant plus ou moins la même chose, abondance et éclatement de la documentation (souvent en anglais), difficultés supplémentaires pour effectuer des choix éclairés et adaptés à l'environnement informatique de travail... Nous nous sommes donc fixés pour objectif de rassembler tous les éléments utiles pour l'usage de R
à l'Insee dans un seul document, en cherchant à aborder le plus grand nombre possible de cas d'usage.
Le projet UtilitR
est un projet collaboratif, évolutif, open source et ouvert à tous, auquel tous les agents peuvent contribuer. Tout agent qui le souhaite peut modifier la documentation ou la compléter en fonction de ses connaissances et de ses expériences (voir [Comment fonctionne le projet UtilitR
?]).
Cette documentation ne prétend pas être exhaustive ou sans erreurs. Elle doit être vue comme une mise en commun des connaissances que les agents détiennent sur l'usage de R
.
Le projet UtilitR
est porté par les agents du réseau LS2 (Logiciels statistiques en Libre Service) de l'Insee. La documentation UtilitR
s'attache à être cohérente avec les recommandations émises par le comité de certification des packages R
(COPS).
Le projet UtilitR
repose sur cinq principes: transparence, ouverture, bienveillance, exigence, reproductibilité.
- Transparence: l'ensemble du projet est librement accessible sur le dépôt Github, sous licence libre;
- Ouverture: tout agent de l'Insee qui le souhaite peut rejoindre le projet à tout moment. Les modalités de contribution peuvent prendre différentes formes, détaillées dans le guide des contributeurs;
- Bienveillance: toutes les idées, initiatives et propositions sont les bienvenues, et les contributeurs veillent à se soutenir les uns les autres;
- Exigence: les modifications de la documentation sont systématiquement soumises à une revue par les contributeurs du projet et ne sont acceptées que lorsqu'elles rencontrent une large approbation;
- Reproductibilité: les exemples développés dans la documentation doivent être reproductibles.
Le projet UtilitR
est un projet collaboratif mené par un groupe de contributeurs qui définissent eux-mêmes le contenu, la structure et le calendrier du projet. Il n'y a pas de hiérarchie au sein du groupe de contributeurs. Cette organisation horizontale implique un effort de dialogue et de concertation, les décisions étant prises à la majorité.
Une fois atteint une taille jugée critique, le projet UtilitR
devra sans doute, pour se pérenniser, prendre une forme plus officielle et institutionnelle. Toutefois, les contributeurs affirment leur attachement à l'approche collaborative et aux cinq principes présentés ci-dessus.
Le projet UtilitR
est actuellement mené par un groupe réduit d'agents de l'Insee. Toute personne qui le souhaite peut rejoindre le projet à tout moment, et toutes les contributions sont les bienvenues: compléments, corrections d'erreur, améliorations, questions... Il n'y a aucun prérequis, et aucun niveau minimal en R
n'est demandé. Tout agent intéressé à contribuer au projet est invité à consulter le guide des contributeurs.