Raphaël Grolimund edited Informations_contextuelles_Le_dernier_point__.md  about 8 years ago

Commit id: f41d40d84f82a1f9f1c7b421d07c6e0fbf49d0a7

deletions | additions      

       

## Informations contextuelles  Le dernier point auquel on doit penser lorsqu'on veut partager son travail, c'est de le décrire pour qu'il  soit intelligible à une personne qui ne l'a pas créé. Les développeurs savent qu'ils doivent (ou devraient) commenter leur code afin que sa lecture soit facilitée. De même, tout ceux qui publient des données doivent en fournir la clé de lecture, car consulter un tableau sans comprendre les en-têtes des colonnes ou connaîtres les valeurs possibles (maximum, minimum) est inutile.   Et Eh  bien il en va de même avec les supports de cours. La mode des _slides_ ne comprenant qu'une photo et quelques mots met en lumière qu'il est important de clarifier le sens de la diapositive et ce qui doit être dit en la projetant. Sans aller jusqu'à donner le texte: l'enseignant n'est pas (tout à fait) un acteur. L'exemple des activités faites en classe est encore plus parlant. Si vous mettez tout le matériel nécessaire à un jeu à disposition, il faut expliquer comment s'en servir.   La collaboartion, je l'expérimente tous les jours avec mes collègues de l'équipe de formation. Ce n'est pas parce qu'on travaille ensemble, qu'on travaille de la même manière ou que nous créons tout ensemble. Et lorsque nous devons reprendre un cours qui a été créé par quelqu'un d'autre, nous nous rendons compte à quel point ce que j'ai décit dans cet article est important. Nous faisons des erreurs et nous en profitons pour apprendre de celles-ci. Mais imaginez-vous si au sein d'une équipe il y a de la diversité, ce que cela peut être lorsque vous reprenez le travail d'une personne que vous connaissez peu ou pas. **Il faut un README.txt ou quelque chose de ce genre!**