Please ignore secret bonuses. Secret tests do NOT award bonus. Max hw grade is 30+2 bonus efficiency

Do you need help?

[RESEARCH] Valutazione della leggibilità del codice

s
simone (25820 points)
47 97 209
in Avvisi by (25.8k points)
edited by

Ciao a tutti.

Come già accennato dal professor Sterbini, ho realizzato un software per valutare la leggibilità di programmi scritti in codice Python. Questo software è in grado di fornire un indice di leggibilità attraverso un classificatore binario che sfrutta un set di feature estratte dal codice sorgente. In particolare, le feature catturano la qualità di identificatori, segnature e commenti, il contenuto semantico del codice, e le corrispondenze tra il linguaggio naturale contenuto nei commenti e le parole che costituiscono gli identificatori.

Quello che manca per completare il software è un collezione di codici la cui leggibilità deve essere stata valutata manualmente da un gruppo di persone. A tal proposito, ho attivato questa semplice form che consente di indicare la leggibilità di alcuni frammenti di codice su una scala di Likert a 5 punti:

  1. Veramente illeggibile
  2. Non leggibile
  3. Poco leggibile
  4. Leggibile
  5. Molto leggibile

Vi chiedo di aiutarmi a completare questo dataset! 

Ho assegnato a ognuno di voi (in realtà ai 200 studenti più bravi) 5 codici da valutare, estratti dai programmi consegnati dai vostri colleghi dello scorso anno. Quello che dovete fare è leggere i codici e valutarne la leggibilità, tenendo conto di quanto sono chiari i nomi scelti per variabili, funzioni ed argomenti, quanto è stato commentato e documentato il codice e quanto sono utili/chiari i commenti. Il task è molto semplice e vi richiederà una manciata di minuti per completarlo. 

Abbiamo deciso di non rendere le valutazioni obbligatorie ma vi chiedo comunque di partecipare numerosi. Se avete poco tempo, potete completare le valutazioni in giorni diversi. Se lo ritenete opportuno, potete anche modificare successivamente le valutazioni assegnate.

Non appena i dati saranno pronti, farò girare il software sui vostri codici e vi mostrerò i risultati. Anche se i valori di leggibilità non verranno presi in considerazione ai fini degli esami, ritengo didatticamente interessante mostrarvi anche questa metrica.

Vi ringrazio anticipatamente per l'aiuto che spero ci fornirete.

Per partecipare: https://q2a.di.uniroma1.it/readability

2 Answers

_andrea_ (45670 points)
11 42 297
by (45.7k points)
Come si fa a partecipare?
v
val9 (9770 points)
6 30 53
by (9.8k points)
_andrea_ (45670 points)
11 42 297
by (45.7k points)
Grazie, ora vedo
T
Tommaso (1480 points)
3 8 22
by (1.5k points)
Io in quella pagina non vedo nulla, è un mio problema?
_andrea_ (45670 points)
11 42 297
by (45.7k points)
Qui dice che sono stati scelti i 200 studenti più bravi, potrebbe essere che non rientri nel limite
s
simone (25820 points)
47 97 209
by (25.8k points)
Esattamente.
andrea.sterbini (207920 points)
750 1267 2373
by (208k points)
Non prendetela come un giudizio ... plis ...
T
Tommaso (1480 points)
3 8 22
by (1.5k points)
ok grazie, nessun problema era per capire
s
simone (25820 points)
47 97 209
by (25.8k points)
Ci tengo a precisare che per stilare la classifica ho preso in considerazione solo quegli studenti che hanno consegnato almeno 6 esercizi.
s
simone (25820 points)
47 97 209
by (25.8k points)

Ho esteso la raccolta dati a tutti gli studenti che hanno consegnato almeno un homework. Partecipate numerosi! devil

a.capobianco1 (16770 points)
11 54 165
by (16.8k points)
Come procede la ricerca?
s
simone (25820 points)
47 97 209
by (25.8k points)

Per il momento hanno partecipato 129 studenti su un totale di 360 (l'obiettivo iniziale era 200).

Le valutazioni raccolte sono 624 su un totale di 1800 (il target è fissato a 1000).

Purtroppo una buona fetta di studenti (circa 40) non vuole partecipare alla raccolta dei dati 

a.capobianco1 (16770 points)
11 54 165
by (16.8k points)
edited by
Potresti espandere il numero totale dei partecipanti e se ti arrivano più valutazioni di quelle che ti mancano tieni solo da quelle dei più alti in classifica. Inoltre potresti fissare questo post sempre al primo posto...

Edit: rileggendo ho visto che quelli che non hai considerato hanno consegnato meno di 6 esercizi.. Quindi includerli forse sarebbe sbagliato... Invece lasciare il post in evidenza potrebbe incoraggiare quelli che mancano...
s
simone (25820 points)
47 97 209
by (25.8k points)

Ti ringrazio per i preziosi consigli (a proposito, ho sistemato la colonna bonus devil).

Abbiamo già esteso la raccolta a tutti gli studenti che hanno consegnato almeno un homework.

Ogni tanto inviamo una notifica per ricordare il task, purtroppo molti studenti accedono al forum ma non hanno 5 minuti di tempo per contribuire alla raccolta dati. 

a.capobianco1 (16770 points)
11 54 165
by (16.8k points)
Non si poteva chiedere di meglio :)