this is for holding javascript data
Raphaël Grolimund added M_tadonn_es_et_informations__.md
about 8 years ago
Commit id: 3215056d5472a1ec2a748d510387365d4345cc82
deletions | additions
diff --git a/M_tadonn_es_et_informations__.md b/M_tadonn_es_et_informations__.md
new file mode 100644
index 0000000..697a19c
--- /dev/null
+++ b/M_tadonn_es_et_informations__.md
...
#Métadonnées et informations complémentaires
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 faut un README.txt ou quelque chose de ce genre!