¿Por qué escribir código legible?

¿Por qué escribir código legible?

La razón por la cual debemos escribir código legible es muy sencilla, es para que otros programadores o desarrolladores nos entiendan, inclusive nosotros mismos después de volver a leer el código que escribimos hace tiempo.

Al escribir código nos convertimos no solamente en creadores de software también nos convertimos en escritores, ya que en cada línea de código demostramos nuestro estilo narrativo y nuestra prosa como tal. A manera de ejemplo, podemos pedirle a varios desarrolladores que resuelvan un problema o necesidad del mundo real y lo harán en la gran mayoría de forma diferente, esto se debe en gran medida a que el código que escribimos  es un reflejo de nuestros pensamientos y del proceso mental que se lleva a cabo.

Así que necesitamos dar a entender nuestras historias plasmadas en el código de forma clara, concisa y evitando la redundancia.

Consejos para escribir  código legible:

• Haz que tu código se describa a sí mismo. Si haces eso no será necesario documentar tu código.
•  Los nombres de las variables deberán ser descriptivos.
• Sigue las pautas y convenciones de tu lenguaje.
• Evita las abreviaciones en los nombres de variables, métodos, etc., con el cuento de ahorrar espacio o código.
• Siempre indenta tu código, esto hará que sea más claro y legible.
• Haz de cuenta que estás escribiendo para alguien más. Pasamos más tiempo leyendo y entendiendo código que escribiéndolo.
• No intentes reinventar la rueda. Utiliza la biblioteca de clases o api de los lenguajes de programación.
• Documenta solo cuando realmente sea necesario. Esto tiene que ver con la primera regla.
• Utiliza estándares de programación.
• Sé autocrítico con tu código.

Hay que tener siempre presente que el código legible hace que sea más fácil entenderlo, depurarlo y darle mantenimiento, con lo cual un buen código que sea legible cumple con las buenas prácticas de desarrollo de software.