Quando leggo le guide di stile di codifica, come la Guida di stile Javascript AirBnB ho appena realizzato che queste spesso non fornisce spiegazioni più profonde perché qualcosa dovrebbe essere fatto in un modo particolare.
Al massimo ci sono brevi affermazioni, raramente link ad es. "Non funzionerà in IE8. Ulteriori informazioni ."
Perché è così? Almeno un elenco di riferimenti o un collegamento a una versione annotata sarebbe più utile, ad es. ai nuovi dipendenti che devono lavorare con una guida di questo tipo.
Ci sono dei controesempi notevoli, per qualsiasi lingua? (Impossibile leggerli tutti)
Considererei queste guide di stile come "documenti viventi" e nel tempo mi aspetterei che diventassero versioni più prolisse con molti link, conservando le lezioni apprese e documentando come evitare oscuri casi limite.
Va bene iniziare con un documento bare-bones. È più facile da leggere. ma non dovrebbe evolvere questi documenti, una versione più lunga che indica una guida di stile più "matura"?