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.
A propos Auteur
Programmation Java: les erreurs de lancer Il est essentiel que votre code Java fait tous les efforts pour résoudre un problème. Cependant, il ya des moments où votre code n'a tout simplement pas assez d'information, ressources, aux droits, ou une autre obligation de régler un…
Résumé rapide de repérer des erreurs dans Java Savoir quand une erreur peut se produire dans votre programme Java est important. Vous devez comprendre quand à regarder pour un problème particulier dans votre application. Cependant, il est également important de comprendre Comment des erreurs…
Les erreurs sémantiques en java Beaucoup de gens trouvent la différence entre les erreurs sémantiques et syntaxiques (syntaxe) erreurs dans le code Java difficile à comprendre, mais ils sont différents. Vous pouvez voir une erreur sémantique lorsque la syntaxe de votre code…
Comment faire pour résoudre les erreurs de syntaxe javascript pour HTML5 et CSS3 programmation Le type le plus commun de l'erreur javascript HTML5 est un fracas ou erreur de syntaxe, ce qui signifie généralement vous avez mal orthographié une commande ou utilisé une fonction de manière incorrecte. Du point de vue de l'utilisateur,…
Comment faire pour récupérer des erreurs dans MATLAB Tout le monde fait des erreurs, même avec MATLAB. Vous pourriez penser que les experts ne font pas d'erreurs, mais tout expert qui le dit est définitivement pas un expert. Faire des erreurs fait partie du processus d'apprentissage. Il fait aussi…
Comment déboguer votre code dans r Une fois que vous avez écrit votre code dans R, il est important de savoir comment déboguer. L'erreur est humaine, et les programmeurs tomber dans ce humaine catégorie ainsi. Personne ne parvient à écrire du code sans erreurs, de…
Comment corriger les erreurs de lecture de données dans r Probablement erreurs les plus courantes en R sont faites lors de la lecture des données à partir de fichiers texte à l'aide read.table () ou read.csv (). Beaucoup d'erreurs entraînent des erreurs R de lancement, mais parfois vous remarquez que…
Comment générer vos propres messages d'erreur dans r Générer vos propres messages peut sembler étrange, mais vous pouvez effectivement éviter des bugs dans R en générant vos propres erreurs. Rappelez-vous l'erreur de logique dans le logitpercent () fonctionner? Il aurait été plus facile à…
Comment lire les erreurs et les avertissements en r Si quelque chose va mal avec votre code, R vous dit. Nous devons l'admettre: Ces messages d'erreur peuvent varier de légèrement déroutant pour totalement incompréhensible si vous n'êtes pas habitué à eux. Mais il n'a pas à rester de cette…
Comment fournir une rétroaction aux utilisateurs du formulaire Web La tendance générale pour les commentaires sur un formulaire web sera de mettre en évidence le domaine qui nécessite une attention et d'activer la messagerie pour le domaine individuel et la forme générale.Pour faciliter la rétroaction,…
Comment affiner votre web validation de formulaire Après que vous avez vérifié vos champs requis et fourni une rétroaction à l'utilisateur, vous avez besoin d'affiner la validation de votre formulaire Web. Avant de le faire, vous devriez faire une pause et regarder le code que vous avez ajouté…
Trouver et éliminer les sources d'erreur sur l'épreuve de la science GED Vous serez appelé à trouver des sources d'erreur pour le test GED Science. Si les scientifiques étaient parfaits, alors chaque expérience se révélera l'hypothèse et être reproductible par tout autre scientifique à tout moment.…
Le menu des rapports drupal Drupal offre un certain nombre de rapports sur l'état de votre site Drupal, les erreurs et les mises à jour pour les modules. Pour afficher ces rapports, connectez-vous à votre site Drupal en tant qu'administrateur et accédez au menu des…
Sept erreurs à éviter en tant que formateur Tout le monde fait des erreurs, mais des erreurs peut sérieusement affecter votre crédibilité en tant que formateur. Évitez de commettre ces erreurs de formation:Démarrage tardif et de perdre du tempsÊtre mal préparé et manque la…