Visualizza i risultati del sondaggio: Quale persona utilizzate per commentare il codice

Chi ha votato
36. Non puoi votare questo sondaggio
  • 1a singolare

    6 16.67%
  • 2a singolare

    3 8.33%
  • 3a singolare

    21 58.33%
  • altro

    6 16.67%
Pagina 1 di 8 1 2 3 ... ultimoultimo
Visualizzazione dei risultati da 1 a 10 su 80
  1. #1
    Moderatore di CSS L'avatar di KillerWorm
    Registrato dal
    Apr 2004
    Messaggi
    5,674

    Le persone nei commenti

    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?
    Installa Forum HTML.it Toolset per una fruizione ottimale del Forum

  2. #2
    Utente di HTML.it
    Registrato dal
    Aug 2001
    Messaggi
    7,261
    Tu non stai bene
    Il re è nudo (cit).

  3. #3
    in terza persona...anche perchè si solito mi trovo a commentare delle funzioni che svolgono un determinato lavoro...
    "Everybody defamates from miles away
    But face to face, they haven't got a thing to say"

  4. #4
    Originariamente inviato da nillio
    Tu non stai bene
    oggi sei particolarmente insofferente o sbaglio?
    "Everybody defamates from miles away
    But face to face, they haven't got a thing to say"

  5. #5
    Utente di HTML.it L'avatar di tognazzi
    Registrato dal
    Jan 2007
    Messaggi
    1,490
    hai dimenticato l'infinito, che non comporta l'uso delle persone.

    "avviare il programma"
    "caricare ecc."

  6. #6
    Utente di HTML.it L'avatar di iBat
    Registrato dal
    Nov 2003
    Messaggi
    867
    per quel poco di stesura di codice che ho fatto, terza persona singolare
    sgt.rossi,01-09-2007 11:33, dice:
    "per quello cn la mucca sull'avatar stai attento a come parli.."

  7. #7
    Originariamente inviato da iBat
    per quel poco di stesura di codice che ho fatto, terza persona singolare
    quoto e sottoscrivo, i commenti andrebbero fatti sempre in terza persona singolare (è il programma a fare le cose, non tu) questo nella teoria. Nella realtà già trovare del codice commentato è una botta di chiulo, figurati se ci si ferma ai dettagli
    il tempo si fa i fatti suoi

  8. #8

  9. #9
    Utente di HTML.it
    Registrato dal
    Aug 2001
    Messaggi
    7,261
    Originariamente inviato da JackBabylon
    quoto e sottoscrivo, i commenti andrebbero fatti sempre in terza persona singolare (è il programma a fare le cose, non tu) questo nella teoria. Nella realtà già trovare del codice commentato è una botta di chiulo, figurati se ci si ferma ai dettagli
    Ma usi il gerundio o l'imperativo?

    E chiedi per favore?
    Il re è nudo (cit).

  10. #10
    Utente di HTML.it
    Registrato dal
    Aug 2001
    Messaggi
    7,261
    Originariamente inviato da jonnym78
    Esatto


    PS -
    Il re è nudo (cit).

Permessi di invio

  • Non puoi inserire discussioni
  • Non puoi inserire repliche
  • Non puoi inserire allegati
  • Non puoi modificare i tuoi messaggi
  •  
Powered by vBulletin® Version 4.2.1
Copyright © 2024 vBulletin Solutions, Inc. All rights reserved.