Capítulo 8. Comentarios
Este trabajo se ha traducido utilizando IA. Agradecemos tus opiniones y comentarios: translation-feedback@oreilly.com
El uso adecuado de los comentarios es compensar nuestra incapacidad para expresarnos en código.
Robert C. Martin, Código limpio: Un manual de artesanía ágil del software
8.0 Introducción
En los tiempos de la programación en lenguaje ensamblador, la distancia entre lo que pretendías decir como programador y cómo funcionaba el ordenador era enorme. Cada pocas líneas (a veces en cada línea), necesitabas una pequeña historia que te ayudara a entender qué significaban las siguientes instrucciones. Hoy en día, los comentarios suelen ser un fallo a la hora de elegir buenos nombres. Sólo los necesitas para describir decisiones de diseño muy importantes. Son código muerto, ya que no compilan ni se ejecutan. Los comentarios tienden a desviarse del código que antes describían. Se convierten en islas flotantes de irrelevancia y extravío en el código. El código limpio casi no necesita comentarios. Puedes encontrar algunos criterios sobre cómo utilizarlos en las siguientes recetas.
Lenguaje ensamblador
El lenguaje ensamblador es un lenguaje de programación de bajo nivel para escribir programas de software para arquitecturas informáticas específicas. Es un código imperativo de lenguaje legible por humanos que está diseñado para traducirse fácilmente a lenguaje máquina, que es el lenguaje que pueden entender los ordenadores.
8.1 Eliminar código comentado ...
Get Libro de cocina de código limpio 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.
