Questo sondaggio è rivolto a tutti i programmatori e tutti coloro che abbiano delle esperienze, se pur blande, di programmazione.
Il quesito è quasi amletico.
Quale persona utilizzate per i commenti delle vostre righe di codice?
O quale pensate sia meglio utilizzare?
Ad esempio io utilizzo la seconda persona singolare nel modo imperativo, come se comandassi al pc di fare delle azioni..
codice:
// avvia il programma
// carica i dati
// muovi il cursore
// mostra l'immagine
// chiudi la finestra
Spesso si commenta però in prima persona, come se fosse il programmatore a compiere direttamente le azioni o come se il pc stesso abbia una propria personalità..
codice:
// avvio il programma
// carico i dati
// muovo il cursore
// mostro l'immagine
// chiudo la finestra
Mentre la terza persona singolare, credo venga utilizzata meno.
Che probabilmente è il modo più corretto perchè descrive appunto cosa fa quella riga di codice.
codice:
// avvia il programma
// carica i dati
// muove il cursore
// mostra l'immagine
// chiude la finestra
A volte si utilizza anche la prima persona plurale, specialmente nella descrizione dei tutorial.
codice:
// avviamo il programma
// carichiamo i dati
// muoviamo il cursore
// mostriamo l'immagine
// chiudiamo la finestra
Poi si utilizza il gerundio in prima persona specialmente per commentare un evento o un'azione duratura o che viene compiuta in un tempo indefinito..
codice:
// Sto avviando il programma
// sto caricando i dati
// sto cliccando il pulsante
Voi che persona utilizzate maggiormente?