Salve a tutti...
Ho appena riconsegnato l'Esercizio 1 dell'HW con i commenti fianco-riga per, appunto, migliorare la qualità di lettura e comprensione del mio codice...
Considerando la lunghezza del codice, però, (circa 300 righe!) ho pensato di commentare nel dettaglio tutte le righe della funzione principale e, nelle funzioni che essa richiama, commentare solo la riga in corrispondenza della definizione della funzione stessa scrivendo quello che fa ed utilizzando le stesse parole che nella funzione principale ho usato in corrispondenza dell'istruzione che richiama quelle determinata funzione, in moda da avere una "giunzione" tra funzione principale e funzioni secondarie.
Le righe di codice inserite nelle funzioni secondarie, però, non le ho commentate, perchè risulterebbe quasi più il lavoro di commento che quello di scrittura del codice...
Chiedo al Prof, o ai suoi collaboratori: potrebbe essere un buon metodo quello che ho utilizzato, per non gravare nè troppo sul tempo dedicato ai commenti, nè troppo sull'incomprensibilità del codice? (Come ho detto ho appena riconsegnato l'Esercizio 1, quindi dovreste aver modo di vedere cosa intendo).
Con una risposta qui, anche gli altri potrebbero farsi un'idea di come organizzare la cosa :)
Saluti al Forum :D
P.s. Ho usato troppe volte la parola "funzione", sorry Ahahahah
Ho appena riconsegnato l'Esercizio 1 dell'HW con i commenti fianco-riga per, appunto, migliorare la qualità di lettura e comprensione del mio codice...
Considerando la lunghezza del codice, però, (circa 300 righe!) ho pensato di commentare nel dettaglio tutte le righe della funzione principale e, nelle funzioni che essa richiama, commentare solo la riga in corrispondenza della definizione della funzione stessa scrivendo quello che fa ed utilizzando le stesse parole che nella funzione principale ho usato in corrispondenza dell'istruzione che richiama quelle determinata funzione, in moda da avere una "giunzione" tra funzione principale e funzioni secondarie.
Le righe di codice inserite nelle funzioni secondarie, però, non le ho commentate, perchè risulterebbe quasi più il lavoro di commento che quello di scrittura del codice...
Chiedo al Prof, o ai suoi collaboratori: potrebbe essere un buon metodo quello che ho utilizzato, per non gravare nè troppo sul tempo dedicato ai commenti, nè troppo sull'incomprensibilità del codice? (Come ho detto ho appena riconsegnato l'Esercizio 1, quindi dovreste aver modo di vedere cosa intendo).
Con una risposta qui, anche gli altri potrebbero farsi un'idea di come organizzare la cosa :)
Saluti al Forum :D
P.s. Ho usato troppe volte la parola "funzione", sorry Ahahahah