Segui gli standard
Best Practice 3 - Segui gli standard definiti, non crearli
La maggior parte delle organizzazioni di software standard mantiene i propri standard di codifica. Questi standard sarebbero stati stabiliti da sviluppatori di software di grande esperienza dopo aver trascorso anni con lo sviluppo di software. Ciò equivale a seguire le orme di grandi persone lasciate dietro di loro.
Se la tua organizzazione non ha alcuno standard, suggerirei di cercare su Internet standard di codifica da diversi linguaggi di programmazione e ne troverai molti. Uno standard di codifica correggerebbe le regole su vari importanti attributi del codice, alcuni sono elencati di seguito:
- Convenzione di denominazione dei file
- Convenzione di denominazione di funzioni e moduli
- Convenzione di denominazione delle variabili
- Storia, rientro, commenti
- Linee guida sulla leggibilità
- Elenco delle cose da fare e da non fare
Ma una volta definiti, inizia a seguire gli standard definiti invece di crearli o modificarli ogni giorno. Direi sicuramente:
Il codice sorgente è il tuo BAMBINO!
Quindi mantienilo pulito, coerente e bello. Quando dico bello, significa davvero bello. Se il tuo codice sembra bello, sarebbe facile per gli altri leggerlo e comprenderlo. Se continuerai a cambiare le regole di codifica ogni giorno, dopo pochi giorni tu stesso non sarai in grado di leggere e comprendere il codice scritto da te.