Un documento standard di codifica è utile. È più utile quando è abbastanza breve da permettere a chiunque di ricordare l'intera cosa senza troppi problemi e quando non causa nessuno troppo dolore.
Il modo in cui scegli di riordinare il codice nella tua organizzazione, o capitalizzare i nomi, o implementare i tuoi loop, o commentare il tuo codice non è poi così importante; la parte utile è far sì che tutti scrivano il codice che sembra lo stesso di tutti gli altri.
- Evita di dover trascorrere un minuto a ricalibrare le tue aspettative su dove dovrebbero essere le parentesi graffe e ogni volta che guardi il codice di qualcun altro.
- Evita di avere diversi stili di codice nello stesso file.
- Forse la cosa più importante, avere uno standard scritto evita argomenti sulle pratiche di codifica durante le revisioni del codice.
Ancora una volta, quali sono gli standard non importa quanto avere una sorta di standard semplice e diretto. Quindi, metti tutti i tuoi sviluppatori in una stanza e lascia che discutano su quali dovrebbero essere gli standard. Questa riunione potrebbe continuare all'infinito, quindi le regole sono:
- Tutto ciò che non è deciso entro la fine della riunione verrà deciso dal gestore.
- L'incontro si concluderà dopo due ore o quando qualcuno inizia a gridare oa piangere, a seconda di cosa viene prima.
- L'intero standard si adatta (in dimensioni ragionevoli!) su un foglio o due di carta, a doppia faccia solo se assolutamente necessario.
Considera l'adozione di qualcuno | altro | standard come punto di partenza per la tua riunione sugli standard di codifica , o come un modo per evitare completamente l'incontro.
Una volta concordato, gli sviluppatori dovrebbero essere in grado (e dovrebbero essere tenuti a) di autogestirsi. Deviazioni occasionali dallo standard non dovrebbero essere un grosso problema (e potrebbero anche essere giustificabili), ma il rifiuto sconsiderato di abbandonare uno stile personale preferito a favore dello standard dovrebbe comportare il trasferimento immediato in ufficio con le condutture dell'acqua che perdono, o qualsiasi altra cosa .
Demian Brecht punta a strumenti per sfilacciare. Questi sono un complemento perfetto per un documento di standard di codifica. È semplicemente buono attenersi agli standard di stile di codifica; è importante attenersi agli standard di codifica relativi alle pratiche pericolose. Nessuno oltre all'autore verificherà che ogni linea di codice soddisfi lo standard per lo stile, ma dovresti sicuramente considerare la possibilità di creare uno strumento di sfilacciamento nel flusso di lavoro del tuo team per rilevare automaticamente i probabili bug. Inoltre, lo strumento stesso può codificare le pratiche accettate in modo che non sia necessario elencarle singolarmente negli standard di codifica; basta specificare la configurazione dello strumento.
Nota: l'idea di "standard di codifica" non è esclusiva della programmazione. Gli "standard di codifica" sono usati in molti campi, a volte all'interno di un'organizzazione, più spesso in un intero settore o professione. Alcuni esempi:
In ciascun caso (e molti altri) un professionista competente potrebbe facilmente capire "codice" che non soddisfa lo standard previsto. Perché così tante industrie continuano a scrivere requisiti dettagliati per i documenti che non hanno nemmeno bisogno di essere analizzati da un compilatore? Perché lo stile è importante . Presentare informazioni in uno stile standard consente al lettore di concentrarsi interamente sul contenuto, rende la lettura più veloce e aiuta a comprendere e riduce gli errori.