Capítulo 30. Cómo nombrar mejor las cosas
Este trabajo se ha traducido utilizando IA. Agradecemos tus opiniones y comentarios: translation-feedback@oreilly.com
Peter Hilton
Lo que se necesita ante todo es dejar que el significado elija la palabra, y no al revés... lo peor que se puede hacer con las palabras es rendirse a ellas.
George Orwell
Mejorar la forma de nombrar las cosas mejora la mantenibilidad del código que escribes más que cualquier otra cosa. Hay mucho más en el código mantenible que una buena nomenclatura, pero nombrar las cosas es famoso por su dificultad, y normalmente se descuida. Afortunadamente, a los programadores les gustan los retos.
En primer lugar, evita los nombres sin sentido (foo) o demasiado abstractos (data), duplicados (data2) o vagos (DataManager), abreviados o cortos (dat). Las letras simples (d) son las peores de todas. Estos nombres son ambiguos, lo que ralentiza a todo el mundo porque los programadores pasan más tiempo leyendo código que escribiéndolo.
A continuación, adopta directrices para mejorar los nombres: palabras con significados precisos que hagan que el código diga lo que quiere decir.
Utiliza hasta cuatro palabras para cada nombre, y no utilices abreviaturas (excepto en id y las que adoptes del dominio del problema). Una palabra rara vez es suficiente; utilizar más de cuatro es torpe y deja de añadir significado. Los programadores ...
Get 97 cosas que todo programador Java debe saber now with the O’Reilly learning platform.
O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.
