La maggior parte dei portfolio da sviluppatore è rotta

Ho esaminato molti portfolio di sviluppatori. Come lead engineer, ho guardato il lavoro dei candidati prima dei colloqui, aiutato persone che seguo a costruire la loro prima presenza professionale online, e di tanto in tanto ho rivisto il mio confrontandolo con quello che vorrei vedere.

Il pattern è quasi sempre lo stesso.

Il cimitero delle todo app

La maggior parte dei portfolio è piena di progetti che esistono per dimostrare che sai programmare. Una todo app. Una dashboard meteo. Il clone di un prodotto famoso. Un'app CRUD con un nome che sembra una startup. A volte sono curati. A volte hanno animazioni belle. Nessuno di questi conta.

Il problema non è che questi progetti siano semplici. Il problema è che non hanno posta in gioco. Nessuno li usa. Nessuna decisione reale è stata presa durante la loro costruzione — solo un tutorial seguito, una lista di funzionalità completata. Dimostrano che sai scrivere codice. Non dicono nulla sulla tua capacità di risolvere problemi.

Nessuno legge la tua pagina "Chi sono"

La maggior parte delle pagine "Chi sono" è invisibile. Muri di "sono appassionato di soluzioni scalabili" che non comunicano nulla. Una lista di tecnologie che potrebbe essere copiata da cento altri profili.

A nessuno interessa che tu sia appassionato di React. Tutti sono appassionati di React, o almeno lo dicono. La domanda è cosa hai fatto con React, perché hai fatto certe scelte, cosa è andato storto.

I progetti senza contesto non significano nulla

Il secondo fallimento più comune: un progetto con un titolo, un link a GitHub e una descrizione di una riga. "Piattaforma e-commerce costruita con Next.js e Stripe." Ok. E allora?

Che problema stavi risolvendo? Cos'era difficile? Cosa avresti fatto diversamente? Cos'hai rilasciato e cosa hai tagliato? Chi lo usa?

Senza risposte a queste domande, un progetto è solo un repository. Un repository mi dice che sai scrivere codice. Non mi dice se voglio lavorare con te.

Cosa segnala davvero la capacità

I portfolio che si distinguono hanno alcune cose in comune.

Utenti reali. Se qualcosa che hai costruito viene usato da persone che non erano obbligate a usarlo, dillo. I numeri aiutano. "Usato da 200 barbershop in Italia" è più interessante di "un'applicazione per la gestione delle prenotazioni." L'uso reale implica requisiti reali, casi limite reali, decisioni reali sotto pressione.

Specificità sui tradeoff. Gli ingegneri con cui voglio lavorare di più sono quelli che sanno spiegare perché hanno fatto una scelta — e a cosa hanno rinunciato per farla. "Ho scelto SQLite invece di Postgres perché il modello di deployment doveva essere self-hosted senza configurazione" mi dice più sul giudizio di qualcuno che un elenco di ogni database che abbiano mai usato.

Scrittura onesta. Un post che dice "ho provato questo approccio, non ha funzionato per via di X, quindi ho fatto Y" vale più di un write-up impeccabile in cui tutto è andato secondo i piani. L'ingegneria reale è piena di vicoli ciechi. Nasconderli dal tuo portfolio significa nascondere la parte più interessante del lavoro.

Il vantaggio dello scrivere

Questa è la cosa più sottoutilizzata nei portfolio degli sviluppatori: la maggior parte delle persone non scrive. Se scrivi, sei automaticamente in un insieme più piccolo. Non perché scrivere dimostri che sei un ingegnere migliore — non lo fa, direttamente. Ma dimostra che sai spiegare il tuo ragionamento, che è qualcosa che ti verrà chiesto continuamente da ingegnere senior. E crea una traccia di come funziona la tua mente che nessun profilo GitHub può replicare.

Non devi pubblicare spesso. Un post onesto su qualcosa che hai davvero costruito — cos'era, perché l'hai costruito, cosa ti ha sorpreso — vale più di un README perfettamente ottimizzato su una todo app.

Cosa guardo davvero

Quando esamino un portfolio prima di un colloquio, cerco prove di giudizio. Non la tecnologia più impressionante, non il design migliore, non il numero più alto di progetti. Il giudizio. Ha preso decisioni reali? Capisce i tradeoff che ha fatto? Sa spiegare cosa ha costruito in modo onesto e specifico?

Se vedo questo, sono interessato. Se vedo una todo app con una dark mode, parlerò comunque con te — ma hai reso il mio lavoro più difficile.

Costruisci qualcosa di reale. Scrivi di cosa è stato difficile. È tutto qui.