Tidy First?

Capitolo 5. Ordine di lettura

Questo lavoro è stato tradotto utilizzando l'AI. Siamo lieti di ricevere il tuo feedback e i tuoi commenti: [e-mail]

Supponiamo che tu stia leggendo un file (possiamo discutere se il codice sorgente debba essere inserito nei file un altro giorno). Leggi tutto il file, arrivi alla fine ed eccolo lì! Il dettaglio che ti avrebbe aiutato a capire tutto il resto del file.

Riordina il codice nel file nell'ordine in cui un lettore (ricorda che ci sono molti lettori per ogni scrittore) preferisce incontrarlo.

Sei un lettore. L'hai letto e basta. Quindi lo sai.

Resisti alla tentazione di applicare altri riordini nello stesso momento. Probabilmente durante la lettura avrai notato altri dettagli che rendono la comprensione e il cambiamento più difficili del dovuto. Ci sarà tempo per questi dettagli più tardi. In alternativa, riordina questi dettagli ora e rimescola l'ordine di lettura in un riordino successivo. Non mescolare.

Alcuni linguaggi sono sensibili all'ordine di dichiarazione degli elementi. Cioè, cambiando l'ordine di dichiarazione della funzione A e della funzione B si ottengono risultati di esecuzione diversi. Fai attenzione in questi linguaggi. Magari non riordinare l'intero file, ma solo le parti più rilevanti per i lettori.

Nessun ordine di elementi è perfetto. A volte vuoi capire prima le primitive e poi capire come si compongono; a volte vuoi capire prima l'API e poi i dettagli dell'implementazione. Sei tu il lettore, ...