Cómo dar comentarios sobre representaciones

Dar comentarios sobre una representación es distinto de dar comentarios sobre una solución concreta.

Los comentarios sobre una representación se aplican a varias soluciones

La clave de los comentarios sobre una representación es que se aplican a varias soluciones. No conviene comentar nada de lo que normalice el representer, porque no tienes forma de saber cuál era la sintaxis original de una solución concreta.

Por ejemplo, muchos representers normalizan el espacio en blanco de una solución. Por lo tanto, aunque la solución que se muestra en la interfaz de comentarios de la representación pueda tener problemas de formato, no deberías comentarlos, ya que otras soluciones con la misma representación podrían no tenerlos.

Otro ejemplo es el de los nombres de variables, funciones, métodos o clases. Como los representers podrían normalizar los nombres de los identificadores, tampoco deberías comentarlos. Aunque tu representer actualmente no normalice los nombres de los identificadores, aun así no deberías comentarlos, ya que es una normalización que probablemente se añada a un representer más adelante.

No dupliques los comentarios del analizador

Como los estudiantes verán tanto los comentarios del representer como los del analizador, asegúrate de no duplicar comentarios. Para ayudarte con esto, los comentarios del analizador se muestran en la página de comentarios de la representación.

Comentarios en borrador

Si una representación tiene comentarios y se da alguna de estas circunstancias:

• cambió la versión del representer del ejercicio, o
• cambió la versión de la representación

se creará una nueva representación.

Es probable que los comentarios de la representación anterior también se apliquen a la nueva representación, pero no podemos estar seguros. Por eso, copiamos los comentarios de la representación anterior como comentarios en borrador para la nueva representación. El borrador de comentarios de la nueva representación no hace que sus comentarios se apliquen a las soluciones con esa representación. En su lugar, el borrador de comentarios se usa para rellenar de antemano los comentarios cuando un supermentor quiere dar comentarios sobre la nueva representación.