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

Commit id: e1290cc168e525195795980947d6bd3246f1126d

deletions | additions      

       

## Informations contextuelles  Le dernier point auquel on pense doit penser  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.