Introducción

Completado

El código que escriba deberá comunicar su intención tanto al compilador como a otros desarrolladores que puedan leerlo. Y como usted es el desarrollador que leerá el código con más frecuencia, a veces meses después de haberlo escrito, es por su propio bien escribir código claro y fácil de entender. Recuerde que puede escribir código una vez, pero tendrá que leerlo muchas veces.

Supongamos que se le ha pedido que escriba código para otro grupo de desarrolladores. Se reúne con ellos para analizar la especificación y la tarea es clara. Después de la reunión, le dicen que trabajará de forma independiente durante el desarrollo. Una vez que haya terminado, entregará el código al otro grupo. La tarea de codificación no está fuera de sus competencias, pero nunca ha tenido que escribir código que mantenga otra persona. El equipo le ha dicho que, siempre y cuando siga las convenciones de codificación estándar para C#, no debería haber ningún problema. Tiene previsto revisar las convenciones de codificación de C# relacionadas con el código en el que va a trabajar.

En este módulo, elegirá nombres descriptivos para las variables que describan su propósito y su intención. Aprenderá a agregar comentarios de código que documenten los requisitos generales y su enfoque en el código y que indiquen al compilador que omita temporalmente líneas de código. Por último, aprenderá cómo se pueden usar los espacios en blanco para ayudar a transmitir la relación entre líneas de código individuales.

Al final de este módulo, escribirá código de forma más intencionada y se centrará en la legibilidad y la calidad del código para comunicarse con el compilador y con otros desarrolladores.

Importante

Este módulo incluye actividades prácticas que requieren Visual Studio Code. Necesitaremos acceso a un entorno de desarrollo con Visual Studio Code instalado y configurado para el desarrollo de aplicaciones en C#.

Objetivos de aprendizaje

En este módulo, aprenderá a:

• Elegir un nombre descriptivo para las variables que describa su propósito y su intención.
• Usar los comentarios de código para indicar temporalmente al compilador que omita ciertas líneas de código.
• Usar los comentarios de código para describir los requisitos de nivel superior o el propósito de un fragmento de código.
• Escribir código que use los espacios en blanco de forma eficaz para transmitir la relación entre las líneas de código.

Requisitos previos

• Experiencia con el uso de Visual Studio Code para crear y ejecutar aplicaciones de consola de C#.
• Experimente la impresión de mensajes en la consola mediante Console.WriteLine().
• Experimente el uso de las instrucciones if y else if para crear ramas de código.