Evitar erros com bons comentários

Video: Dicas do Laercio: 6 erros que você deve evitar no treino de costas

Muitas pessoas demitir comentários como um exercício projetado para perder tempo. Mas os comentários são realmente inestimável para ajudar você a se lembrar por que você fez algo de uma certa maneira e evitar técnicas que não funcionaram no passado. Além documentação geral, no entanto, os comentários podem ajudar a evitar erros.

Video: TECNICA INFALÍVEL PARA NUNCA PLAGIAR | 12 DE 30

A seguir estão alguns dos benefícios que você derivar de bons comentários:

• Os comentários podem documentar técnicas que tenham ou não tenham trabalhado no passado.

• Você pode usar os comentários como um meio de dizer a alguém o propósito de um script, função ou método - reduzindo o potencial de usar o código errado para uma necessidade particular.

• Um bom comentário diz por que algo seja feito de uma certa maneira, o que ajuda a garantir que as mudanças de código não introduzir erros.

• 
  
  
  

  meios comentando completos documentar as entradas e saídas para que todos saibam como interagir com um script, função ou método.

• Saber quem contactar sobre um assunto em particular é uma primeira linha de defesa contra erros porque o originador geralmente pode dizer a alguém como para evitar problemas.

• Documentando o ambiente no qual o código é projetado para operar ajuda a entender quando erros são causados ​​por atualizações para outros softwares (e não o script, função ou método em si).

Video: Falha ao postar o comentário no Youtube - Como resolver

A melhor política é para evitar erros sempre que puder. Evitar um erro é sempre menos dispendioso do que se recuperar de um erro. No entanto, o erro mais caro de todos é aquele que é fatal e faz com que o aplicativo falhar. Quando os aplicativos de acidente, as pessoas perdem dados e organizações perder clientes. documentação adequada ajuda as pessoas a entender o seu código melhor e evitar erros antes que eles aconteçam (ou mesmo antes que alguém pode pensar em uma maneira de fazer o erro no primeiro lugar).

O melhor comentário no mundo não pode evitar todos os erros. Alguns erros simplesmente acontecer, e não há nada que você possa fazer sobre eles. Por exemplo, você não pode evitar um erro que ocorre como resultado de um raio (erros de dados introduzidos pela corrente elétrica induzida em uma conexão de rede). Às vezes, falhas de hardware e software de terceiros que MATLAB usa para executar tarefas podem conter erros, também. Muitas fontes de erros estão fora de seu controle, mas usando comentários efetivamente ajuda a reduzir o número de erros que você pode controlar.