Estou tentando explicar a alguém que a maneira como eles escreveram o código dificulta a compreensão e, se você o refatorar, fica mais fácil ler. Esse estilo de código em que estou dirigindo é comumente chamado de código 'idiomático'.
Mas a frase código idiomático traz consigo uma bagagem de correção moral , o que não é um grande motivador para levar as pessoas a mudarem seu estilo de codificação. Uma maneira mais positiva de dizer isso é o código que segue o estilo comum - mas para um pensador crítico que aparece como raciocínio de mentalidade de rebanho.
O jeito que eu explico essa ideia de uma maneira que motiva as pessoas a mudar seu código é:
- escrever o código de maneira a reduzir a sobrecarga cognitiva do leitor (por exemplo, não me lembro se esse é o primeiro tipo de vetor - ou o quinto tipo de vetor)
- código que facilita a compreensão da intenção (por exemplo, para que serve esse vetor?)
(Como um aparte, eu sei que o livro The Joy of Clojure, antes de sua primeira publicação, tinha o rascunho de título Idiomatic Clojure. Portanto, parece uma razão para tornar o código 'idiomático', para 'trazer alegria' ao leitor )
Minha pergunta é: o objetivo por trás do código é 'idiomático' para reduzir a sobrecarga cognitiva?