Documentación de Código

¿Cuál es el propósito de documentar el código de un programa?

• Para extender el programa con nuevas capacidades

• Para que los humanos entiendan qué están haciendo y por qué

• Para que los ordenadores sepan qué hacer

• Para dejar la obra rematada

¿Por qué es importante documentar un programa?

• Para reparar errores y extender el programa con nuevas capacidades

• Para que los programadores dejen la obra rematada

• Para pergeñar una solución y escribirla en el lenguaje correspondiente

• Para que los ordenadores ejecuten ciegamente el programa

¿Qué significa documentar en el contexto de programación?

• Añadir suficiente información para explicar lo que hace el programa

• Dejar la obra rematada

• Escribir en el lenguaje correspondiente para que el ordenador ejecute ciegamente

• Reparar errores y extender el programa con nuevas capacidades

¿Qué reglas se deben seguir al documentar un programa?

• Documentar solo lo evidente

• No añadir explicaciones a lo que no es evidente

• Repetir lo que se hace en lugar de explicar por qué se hace

• Añadir explicaciones a todo lo que no es evidente

¿Cuándo hay que poner un comentario en el código?

• Cuando se quiere explicar por qué se hace algo raro

• Cuando se quiere prolongar a lo largo de varias líneas

• Cuando se quiere comenzar con los caracteres "//"

• Cuando se quiere terminar con los caracteres "*/"

¿Cuántos tipos de comentarios existen en Java?

• 4

• 3

• 2

• 1

¿Cuál es el propósito de la notación javadoc en Java?

• Introducir comentarios al principio de cada clase

• Introducir comentarios al principio de cada método

• Introducir comentarios al principio de fragmento de código no evidente

• Introducir comentarios ante cada variable de clase

¿Cuándo se deben poner comentarios por obligación en Java?

• Al principio de fragmento de código no evidente

• Ante cada variable de clase

• Al principio de cada método

• Al principio de cada clase

¿Cuál es el propósito de los comentarios de una línea en Java?

• Comenzar con los caracteres "//"

• Terminar con los caracteres "*/"

• Explicar por qué se hace algo raro

• Prolongar a lo largo de varias líneas

¿Cuándo hay que poner un comentario de una línea en Java?

• Siempre que el código no sea evidente

• Siempre que hagamos algo raro

• Siempre que se quiere terminar con los caracteres "*/"

• Siempre que se quiere prolongar a lo largo de varias líneas