Juste un commentaire

Programmation R défensive

Colin Gillespie

Jumping Rivers

Je ne sais pas vous…

  • Un code évident aujourd'hui
  • L'est souvent beaucoup moins dans quelques semaines
Programmation R défensive

Commentaires

  • Vous pouvez ajouter des commentaires à votre code R avec #
  • Écrire de bons commentaires est en fait délicat !
# Ceci est un commentaire
# Le commentaire ci-dessus n'est pas très utile
# Ou bien si ?
Programmation R défensive

Astuce 1 : évitez les commentaires évidents

  • Ce qui est « évident » n'est pas toujours simple à trancher
    • Par exemple, les commentaires
       # Parcourir les jeux de données
 for (dataset in datasets) {
  # Lire le jeu de données
  r <- read.csv(dataset)
 }
      semblent raisonnables
    • Mais sont peut-être un peu trop évidents
Programmation R défensive

Astuce 2 : évitez les commentaires que vous ne mettrez jamais à jour

L'exemple le plus courant : des en-têtes de fichier

# Dernière mise à jour : 1967-02-25
# Auteur : D Law
# Statut : No 1
  • Ces commentaires-là ne sont presque jamais mis à jour
  • J'ai déjà vu # list of packages used: XXX, YYY
Programmation R défensive

Astuce 3 : soyez cohérent

  • Commencez toujours par un seul # ou un double ##
  • Commencez par une majuscule – respectez la grammaire
  • Prudence avec l'humour
    • Ce qui vous fait rire peut offenser d'autres personnes
  • Commentez le code qui « a l'air faux »
  • Utilisez # TODO ou # XXX pour signaler un point à traiter plus tard
Programmation R défensive

Passons à la pratique !

Programmation R défensive

Preparing Video For Download...