AdvPL

Não!

misture regra de negócio com regra de tela

Não!

exagere nos macros

Não!

duplique código e nem exagere no CTRL+C/CTRL+V

Porque...

  • você duplica o esforço de manutenção
  • torna o módulo ainda mais complexo do que ele já é
  • é um sinal de que a função duplicada não está modular
  • adiciona overhead cognitivo
  • você não recebe por linhas de código

Não!

seja redundante nas condições e operadores

Não!

tenha medo de usar espaços

Não!

inicialize variáveis de maneira redundante

Não!

exagere no tamanho das funções e arquivos

Não!

use termos como genérico ou util

Não!

chame as variáveis/funções de x, i, nem seja um Joel Santana

Não!

use variáveis públicas ou privadas sem um bom motivo

Porque...

  • elas tiveram um motivo para serem depreciadas
  • postergar sua morte requer custos com eventual manutenção
  • podem ser removidas e quebrar compatibilidade

Não!

use funções ou comandos obsoletos

Não!

comece em um lugar e termine em outro

Não!

acople a responsabilidade entre classes

Não!

use STATICCALL

Não!

faça um hadouken!

Porque...

  • over-engineering dificulta o raciocínio sobre o programa
  • ter de pensar muito para ler é sinal que alguém não pensou para escrever

Não!

use números mágicos

Não!

abuse dos parâmetros

*adquira já a versão premium para continuar lendo os parâmetros dessa função!

deck

By Marcelo Camargo