Reflexión: lecciones de la codificación

Por Mark Nichols

Uno de los primeros consejos proporcionados al aprender a codificar es comentar para que la persona que mantiene el código (usted u otra persona) pueda mantenerla con éxito. En el artículo 10 consejos para escribir más limpio y mejor código *, Joel Lee sugiere que simplemente comentar no es suficiente y realmente puede llegar a ser gravoso cuando no se hace correctamente. Él da la regla de oro que "los comentarios existen para explicar por qué existe un fragmento de código en lugar de lo que el código realmente hace." 

Si bien no es un paralelo perfecto, hay algo de verdad en esto al considerar cómo hacer reflexiones efectivas durante el proceso de aprendizaje basado en el desafío (CBL). La reflexión es una pieza clave del marco CBL porque permite al alumno pensar profundamente en el proceso y tomar conciencia de cómo toman decisiones y aprenden. Si cada vez que hago frente a un reto me hago más consciente de mis procesos de pensamiento y tendencias el mejor aprendiz que se convertirá. A medida que me convierta en un mejor alumno desarrollaré mejores soluciones. 

Sin embargo, a menudo las reflexiones en el proceso CBL se convierten en una narrativa básica de la experiencia. Primero, hicimos esto, luego lo hicimos, y finalmente lo hicimos. Si bien debe haber alguna Descripción de lo que sucedió (el código) la parte más importante es hacer comentarios efectivos. ¿Por qué hice esto? ¿Qué pasó cuando lo hice? ¿Cómo impacta a los participantes? ¿Cómo me sentía al respecto? ¿Qué pasa si he intentado otra cosa? ¿Qué podría hacer diferente la próxima vez? Este comentario reflexivo sobre el código de nuestras experiencias nos ayudará (mentores y estudiantes) a ser mejores aprendices y practicantes de CBL. Si no reflexionamos o simplemente Describimos nuestras actividades, nunca desarrollaremos los profundos conocimientos que nos ayudarán a ser mejores aprendices y maestros.

* https://www.makeuseof.com/tag/10-Tips-Writing-Cleaner-Better-Code/