Skip to content

Latest commit

 

History

History
43 lines (24 loc) · 4.7 KB

Manifeste.md

File metadata and controls

43 lines (24 loc) · 4.7 KB

Manifeste du projet UtilitR

Qu'est-ce que le projet UtilitR?

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.

Dans quel contexte le projet UtilitR a-t-il été lancé?

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.

Pourquoi avons-nous lancé UtilitR ?

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.

Quelle est la spécificité du projet UtilitR?

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.

Quelle est la place du projet UtilitR à l'Insee?

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

Quelles sont les valeurs du projet UtilitR?

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.

Comment fonctionne le projet UtilitR?

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.

Comment contribuer au projet UtilitR?

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.