Introduzione
Il codice scritto deve comunicare la finalità sia al compilatore che ad altri sviluppatori che potrebbero dover leggere il codice. E dal momento che si è lo sviluppatore che leggerà il codice più spesso, a volte a distanza di mesi dopo averlo scritto originariamente, è nel proprio interesse scrivere codice chiaro e facile da comprendere. Tenere presente che si scriverà codice una sola volta ma si dovrà leggerlo molte volte.
Si supponga di aver ricevuto una richiesta che prevede di scrivere del codice per un altro gruppo di sviluppatori. Ci si incontra con loro per discutere delle specifiche e l’incarico è chiaro. Dopo la riunione, si verrà informati che si lavorerà in modo indipendente durante lo sviluppo. Al termine di questa fase, si passerà il codice all'altro gruppo di sviluppatori. L'attività di scrittura di codice non è al di sopra del tuo livello di competenza, ma non hai mai dovuto scrivere codice che dovrà essere mantenuto da qualcun altro. Il team riferisce che purché si seguano le convenzioni di scrittura di codice standard per C#, non dovrebbe esserci alcun problema. Si prevede di esaminare le convenzioni di scrittura di codice C# correlate al codice su cui si intende lavorare.
In questo modulo si apprenderà come scegliere i nomi per le variabili che descrivono i propri scopi e finalità. Si apprenderà come aggiungere commenti di codice che documentino i requisiti di livello superiore e l'approccio di codice usato, nonché per indicare temporaneamente al compilatore di ignorare righe di codice. Si apprenderà infine come sia possibile usare lo spazio vuoto per comunicare la relazione delle singole righe di codice.
Alla fine di questo modulo sarà possibile scrivere codice in modo più mirato, concentrandosi sulla leggibilità e sulla qualità del codice per comunicare sia con il compilatore che con gli altri sviluppatori.
Importante
Questo modulo include attività di codifica che richiedono Visual Studio Code. Sarà necessario accedere a un ambiente di sviluppo con Visual Studio Code installato e configurato per lo sviluppo di applicazioni C#.
Obiettivi di apprendimento
Contenuto del modulo:
- Scegliere un nome descrittivo per le variabili che descrivono lo scopo e la finalità.
- Usare i commenti del codice per impostare temporaneamente il compilatore per ignorare le righe di codice.
- Usare i commenti di codice per descrivere i requisiti di livello superiore o lo scopo di un passaggio del codice.
- Scrivere codice che usa in modo efficace lo spazio vuoto per comunicare la relazione delle righe di codice.
Prerequisiti
- Esperienza nell'uso di Visual Studio Code per creare ed eseguire applicazioni console C#.
- Sperimentare la stampa di messaggi nella console usando
Console.WriteLine(). - Esperienza nell'uso delle istruzioni
ifeelse ifper creare rami di codice.