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

Commit id: ee731f079eba87caa58b2cb693d17309b9094e8f

deletions | additions      

       

Le dernier point auquel on pense lorsqu'on veut partager son travail, c'est de le décrire pour 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 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. Il 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! genre!**