Come dare feedback sulle rappresentazioni

Dare feedback su una rappresentazione è diverso dal dare feedback su una singola soluzione.

Il feedback sulle rappresentazioni si applica a più soluzioni

La cosa fondamentale del feedback sulle rappresentazioni è che si applica a più soluzioni. Tutto ciò che il representer normalizza non va commentato, perché non hai modo di sapere qual era la sintassi originale di una determinata soluzione.

Ad esempio, molti representer normalizzano gli spazi bianchi di una soluzione. Quindi, anche se la soluzione mostrata nell'interfaccia di feedback sulla rappresentazione può avere problemi di formattazione, non dovresti commentarli: altre soluzioni con la stessa rappresentazione potrebbero non averli.

Un altro esempio è la scelta dei nomi di variabili, funzioni, metodi o classi. Dato che i representer potrebbero normalizzare i nomi degli identificatori, non dovresti commentarli. Anche se il tuo representer al momento non normalizza i nomi degli identificatori, non dovresti comunque commentarli: è una normalizzazione che probabilmente verrà aggiunta in seguito a un representer.

Non duplicare i commenti dell'analyzer

Dato che gli studenti vedranno sia i commenti del representer sia quelli dell'analyzer, assicurati di non duplicare i commenti. Per aiutarti in questo, i commenti dell'analyzer sono mostrati nella pagina di feedback sulla rappresentazione.

Feedback in bozza

Se una rappresentazione ha un feedback e si verifica almeno una di queste condizioni:

• la versione del representer dell'esercizio è cambiata, oppure
• la versione della rappresentazione è cambiata

verrà creata una nuova rappresentazione.

Il feedback della vecchia rappresentazione probabilmente vale anche per la nuova, ma non possiamo esserne certi. Quindi copiamo il feedback della vecchia rappresentazione come feedback in bozza per la nuova rappresentazione. Il feedback in bozza della nuova rappresentazione non fa sì che i suoi commenti vengano applicati alle soluzioni con quella rappresentazione. Il feedback in bozza serve invece a precompilare il feedback quando un supermentor vuole dare un feedback sulla nuova rappresentazione.