Sembra che il poster originale sia già stato efficacemente, ma ha deprecato in modo informale la loro API (tutto ciò che viene chiamato "vecchia API"). Tuttavia, fino a quando non viene annunciato e agli utenti viene comunicato che un'API è obsoleta, non è formalmente obsoleta.
L'API obsoleta è una fase temporanea e inattiva del codice. Sono gli ultimi riti. Questo è il periodo che consente agli utenti / consumatori di riconfigurare le proprie app per una nuova API e di salutare con affetto, facendo pace con l'API. Alcune API potrebbero rimanere più a lungo di altre, ma a questo punto sappiamo che il loro tempo non è lungo.
L'API eliminata è un funerale di codice. Non c'è altro che possa fare, ma adeguatamente disposto e opportunamente memorizzato.
Molti sviluppatori di API e servizi optano per i funerali di codice piuttosto che eseguire gli ultimi riti; tuttavia, penso che sia alquanto rischioso. Se è stato fatto qualche tipo di servizio o promessa di supporto quando l'API / servizio è stato inizialmente adottato o tramite rinnovo, potresti voler onorare tale impegno per un periodo di tempo ragionevole prima di eseguire il funerale.
Per le librerie non di servizio, penso che una versione di rilascio principale, indipendentemente dal periodo di tempo, sia probabilmente un periodo più che accettabile ed equo di compatibilità con le versioni precedenti garantite. Oltre a ciò dipende dall'influenza e dalle pressioni esercitate dagli utenti per estendere la sua vita oltre quel periodo. E non essere sorpreso se di tanto in tanto ci sono obiezioni a causa di insostituibili dipendenze di terze parti bloccate nel limbo e legate a determinate versioni di determinate piattaforme.
Per quanto riguarda i servizi, sospetto che potresti voler esaminare un periodo di sei mesi o di un anno, semplicemente a causa della varianza tra chi e come un servizio può essere consumato e la corrispondente varianza del ciclo di sviluppo da consumare progetto a consumare progetto - molti progetti che potrebbero consumare il tuo servizio potrebbero comunque essere progettati in maniera anticipata e potrebbero pianificare un ciclo di rilascio superiore a un anno. La maggior parte delle opinioni degli sviluppatori dall'esterno suggeriscono che coloro che hanno pianificazioni lunghe sono responsabili del rispetto dei tempi del ciclo e che i progetti che richiedono un ciclo lungo dovrebbero adottare un ciclo di rilascio più rapido, e potrebbe essere vero. Ma alla fine la data di cancellazione è qualcosa che devi negoziare con gli utenti.
Una strategia valida ma non a prova di proiettile potrebbe essere quando si annuncia la deprecazione, evidenziare il periodo di tempo per l'intenzione di eliminare, insieme a una richiesta di commento o obiezione in un formato di sondaggio delle sezioni API in questione. Se non disponi di un elenco di contatti degli utenti perché il tuo servizio opera con accesso [semi] anonimo, potresti prendere in considerazione la ricerca di registri per utenti frequenti e attivi e inviare la notifica all'host o all'amministratore del dominio per inoltrarli come meglio ritiene opportuno.