Ogni riga di codice ha un costo di manutenzione: va letta, aggiornata, protetta, provata. Un sistema vecchio che nessuno ama ma che qualcuno usa ancora è un debito che cresce. Deprecare e migrare significa decidere con metodo quando ritirare qualcosa e come portare gli utenti altrove senza sorprese.
Il codice come passività
Il punto di partenza è un cambio di prospettiva: il codice non è un bene da conservare, è una passività da mantenere. Si tiene perché serve, non perché è già stato scritto. La domanda non è "possiamo spegnerlo?" ma "quanto costa tenerlo rispetto a ciò che dà?".
Decidere se ritirare
Alcune domande aiutano.
- Chi lo usa ancora, e quanto? (Con dati di utilizzo, non con impressioni.)
- Esiste un sostituto che copre davvero i casi d'uso, o solo quelli principali?
- Quanto costa mantenerlo (tempo, rischio, competenze rare)?
- Che cosa succede agli utenti rimasti, e a quali condizioni si possono accompagnare?
Se la risposta è "non lo sappiamo", il primo lavoro è misurare l'uso.
Il processo di deprecazione
1. Annunciare, con una data. Dire cosa viene ritirato, perché, che cosa lo sostituisce e entro quando. Un annuncio senza data non produce migrazioni.
2. Rendere possibile la migrazione. Fornire il percorso: guida, strumenti, esempi, supporto. Se migrare è difficile, gli utenti non lo faranno.
3. Segnalare l'uso. Il sistema vecchio avvisa chi lo usa (messaggi, intestazioni, log), così nessuno è colto di sorpresa.
4. Migrare gradualmente. Per gruppi, partendo dai più semplici o dai più collaborativi. Si tengono i due sistemi in parallelo per il tempo necessario, e si confrontano i risultati.
5. Spegnere quando l'uso è a zero (o quando l'uso residuo è deciso come accettabile). Non prima. Spegnere un sistema con utenti attivi è una interruzione di servizio.
6. Rimuovere. Si elimina il codice, la configurazione, la documentazione, i dati non più necessari (rispettando gli obblighi di conservazione). Il lavoro finisce quando il codice non c'è più, non quando l'avviso è stato inviato.
Il codice di compatibilità
Il codice che tiene vivo il vecchio comportamento per i vecchi utenti ha una data di fine: se non ce l'ha, diventa permanente. Si segna con un commento che dice chi lo usa e quando si toglie.
Segnali d'allarme
- Un sistema "deprecato" senza data di spegnimento.
- Nessuna misura dell'uso reale.
- Un sostituto che non copre tutti i casi d'uso.
- Spegnimento con utenti ancora attivi.
- Codice di compatibilità senza scadenza.
- Due sistemi in parallelo per anni.
Un esempio
Un'API interna di versione 1 è usata da undici servizi. Si misura l'uso: sette l'hanno già abbandonata, quattro no. Si annuncia lo spegnimento con una data, si prepara la guida di migrazione e si segue ciascuno dei quattro team. A una settimana dalla data l'uso è a zero: si spegne, poi si rimuove il codice.
Quando usarlo
Quando si rimuovono vecchi sistemi, API o funzionalità; quando si migrano utenti da una implementazione a un'altra; quando si decide se mantenere o ritirare il codice esistente.
Questo metodo deriva dalla famiglia di skill open source agent-skills di Addy Osmani (licenza MIT), riscritta e adattata.
Questo articolo è una skill di OIAR
Quello che hai letto è il contenuto di una skill del catalogo OIAR, scritto per le persone. Una conoscenza come questa ma più ricca e profonda, scritta per gli agenti, guida le interviste, l'analisi e il report dentro la piattaforma. Le skill si usano in OIAR: per provarla su un tuo progetto serve un account.
deprecation-and-migrationMetodo per ritirare un sistema e migrare gli utenti: codice come passività, misura dell'uso, annuncio con data, percorso di migrazione, avvisi, migrazione graduale, spegnimento a uso azzerato, rimozione completa. Usarla quando si decide se mantenere o ritirare codice, API o funzionalità.