Erreurs avec de bons commentaires Éviter

Beaucoup de gens rejeter commentaires comme un exercice visant à perdre du temps. Mais les commentaires sont fait une valeur inestimable pour aider à vous rappeler pourquoi vous avez fait quelque chose d'une certaine manière et à éviter les techniques qui ne sont pas fonctionné dans le passé. Au-delà de la documentation générale, cependant, les commentaires peuvent vous aider à éviter les erreurs.

Voici quelques-uns des avantages que vous tirent de bons commentaires:

  • Les commentaires peuvent documenter les techniques qui ont ou ont pas travaillé dans le passé.




  • Vous pouvez utiliser les commentaires comme un moyen de dire à quelqu'un dans le but d'un script, une fonction ou méthode - la réduction de la possibilité d'utiliser le mauvais code pour un besoin particulier.

  • Un bon commentaire explique pourquoi quelque chose est fait d'une certaine manière, ce qui permet de garantir que les changements de code ne pas introduit d'erreurs.

  • Des moyens commentant complets documentant les entrées et sorties de sorte que tout le monde sait comment interagir avec un script, une fonction ou méthode.

  • Savoir qui contacter à propos d'une question particulière est une première ligne de défense contre les erreurs parce que l'expéditeur peut habituellement dire à quelqu'un comment éviter les problèmes.

  • Documenter l'environnement dans lequel le code est conçu pour fonctionner vous aide à comprendre lorsque des erreurs sont causées par des mises à jour d'autres logiciels (et non le script, une fonction ou méthode elle-même).

La meilleure politique est d'éviter les erreurs quand vous le pouvez. Éviter une erreur est toujours moins coûteux que la récupération d'une erreur. Cependant, l'erreur la plus coûteuse de tous est celui qui est fatal et provoque l'application à planter. Lorsque les applications accident, les gens perdent les données et les organisations perdent des clients. Une bonne documentation aide les gens à comprendre votre code mieux et éviter les erreurs avant qu'elles ne surviennent (ou même avant que quelqu'un peut penser à une façon de faire de l'erreur en premier lieu).

Le meilleur commentaire dans le monde ne peut pas empêcher toutes les erreurs. Certaines erreurs se produisent tout simplement, et il n'y a rien que vous pouvez faire à leur sujet. Par exemple, vous ne pouvez pas éviter une erreur qui se produit à la suite d'un coup de foudre (erreurs de données introduites par un courant électrique induit dans une connexion réseau). Parfois, les pépins matériels et logiciels tiers qui MATLAB utilise pour effectuer des tâches peuvent contenir des erreurs, aussi. De nombreuses sources d'erreurs sont hors de votre contrôle, mais en utilisant commentaires aide efficacement à réduire le nombre d'erreurs que vous pouvez contrôler.


» » » » Erreurs avec de bons commentaires Éviter