Parliamo di un altro sviluppatore, fondamentale, e questo sta commentando il tuo codice.
Fino ad ora, potresti avermi visto commentare i commenti ai nostri script.
Ad esempio, proprio qui, ho aggiunto un commento di booleani, e questo dice all'interprete Python, ehi, questo è un
commento, non eseguirlo, è solo per me.
Puoi semplicemente ignorarlo e passare alla riga due.
E l'hai visto.
L'ho semplicemente fatto in Python con il segno.
Non appena Python vede un cancelletto, aggiunge un commento.
E puoi farlo anche dopo una linea.
Posso dire che questo assegna a una variabile.
E anche se possono sembrare due righe, in realtà è solo la parola a capo che sta accadendo
e puoi vedere che l'interprete ignora completamente questi commenti.
Ora, commentare sembra molto, molto semplice, ma è un concetto importante.
E se vuoi essere un buon programmatore in tutte le lingue, abbiamo i commenti.
Ma ci sono giorni buoni e modi cattivi di commentare.
E questo è qualcosa che arriva con la pratica, ma qui ci sono alcune linee guida chiave.
Quando stai commentando il tuo codice, l'idea è che stai aggiungendo commenti preziosi, cioè,
se aggiungo un commento qui che dice, ehi, questa è una variabile del nome del segno, un valore della forza di Andre, un commento come questo
.
Non è molto buono.
Perché?
Bene, perché il tuo codice dovrebbe essere autoesplicativo, giusto?
L'idea è per noi di scrivere codice che sia facile da leggere, facile da capire.
Non sta cercando di essere intelligente.
Invece, dovrebbe leggere come l'inglese.
E qualsiasi programmatore Python lo saprebbe qui.
Stiamo semplicemente aggiungendo Andre come valore del nome.
Stiamo assegnando una variabile e aggiungendo un commento come questo che è autoesplicativo, aggiunge solo confusione al tuo
codice.
Quindi c'è un compromesso qui, è bene commentare il tuo cappotto per, diciamo, se stai
lavorando in team e altri sviluppatori vengono e vogliono capire il tuo codice, ma devi ricordare che questo
principio del codice è facile da leggere .
L'unica volta che vuoi aggiungere commenti al tuo codice è, beh, quando sta succedendo qualcosa di veramente, veramente importante,
dove potrebbe essere un po' complesso, prima decidi, ehi, questo codice è scritto in un modo
che abbia senso?
Ad esempio, se questa fosse la variabile A.
E questa era la variabile B.
Bene, questo potrebbe essere davvero difficile da capire per qualcuno, quindi potresti dire che questa è una bandiera
fantastica.
Ma prima di aggiungere quel commento, vuoi dire a te stesso, forse il mio codice è difficile da leggere,
forse dovrei semplicemente cambiare la variabile in è bello per renderlo più comprensibile.
Ora, questo è qualcosa su cui migliori sempre di più e vuoi usare i commenti come strumento extra per rendere comprensibile
il tuo codice, forse scrivi codice che tra sei mesi vuoi tornare indietro per capire
cosa hai fatto.
Ma ricorda, più commenti non significano necessariamente un codice migliore.
Vuoi essere conciso e mantenere le cose semplici aggiungendo commenti solo quando necessario per aiutare gli altri a capire il tuo
codice, senza cercare di rendere il tuo codice illeggibile più leggibile.
Esploreremo questo argomento e ti daremo consigli su di esso durante il corso.
Ma ricorda questo sviluppatore chiave fondamentale perché ne avrai bisogno per tutta la tua carriera.
A proposito, questo articolo qui ha alcuni punti davvero importanti da cui penso che trarrai davvero beneficio, specialmente nelle migliori pratiche
di commento, puoi leggere alcune delle cose da fare e da non fare e cosa fanno alcuni
dei migliori programmatori quando commentando.
So che sembra sciocco, ma è un concetto importante che la maggior parte dei corsi trascura.
Quindi ti consiglio vivamente di leggere sopra questo.
Lo linko nelle risorse e ci vediamo nel prossimo video.