Dopo aver letto alcune relazioni, ci tengo a precisare un paio di cose, per chi deve ancora consegnare.
- Non ci sono limiti inferiori o superiori sulla lunghezza della relazione, per cui scrivete tutto e in maniera chiara in primis.
- In una relazione da 3 pagine probabilmente manca qualcosa, in una da 30 probabilmente vi siete ripetuti allo sfinimento e probabilmente avete mancato di porre l'attenzione dove serve.
- La relazione deve servire da tramite tra il testo del progetto consegnato (che noi conosciamo) e il codice (che noi non conosciamo). Di fondamentale importanza è spiegare come avete implementato (e perché) tutto quello che non è scritto nel testo del progetto. Ecco un buon punto di partenza: tutte le volte che avete fatto una scelta, questa scelta deve essere scritta e motivata nella relazione.
- Repetita iuvant. La relazione deve essere chiara, non lanciatevi in voli pindarici.