Parece que el póster original ya ha sido efectivo, pero desaprobó informalmente su API (todo lo que se conoce como 'API antigua'). Sin embargo, hasta que se anuncie y se notifique a los usuarios que una API está en desuso, no está en desuso formal.
La API en desuso es una etapa de código provisional e inactiva. Son los últimos ritos. Este es el período que permite a los adoptantes / consumidores reconfigurar sus aplicaciones para una API más nueva y despedirse con cariño, haciendo las paces con la API. Algunas API pueden demorar más tiempo que otras, pero en este punto sabemos que su tiempo no es largo.
API eliminada es un código de funeral. No hay nada más que pueda hacer, sino que esté debidamente dispuesto y debidamente memorizado.
Muchos desarrolladores de API y servicios optan por funerales de código en lugar de realizar los últimos ritos; Sin embargo, creo que es algo arriesgado. Si se hizo algún tipo de servicio o promesa de soporte cuando el API / servicio se adoptó inicialmente o mediante la renovación, es posible que desee cumplir ese compromiso por un período de tiempo razonable antes de realizar el funeral.
Para las bibliotecas que no son de servicio, creo que una versión de lanzamiento principal, independientemente del período de tiempo, es probablemente un período más que aceptable y justo de compatibilidad retroactiva garantizada. Más allá de eso, depende de la influencia y el cabildeo de los usuarios para extender su vida más allá de ese período. Y no se sorprenda si de vez en cuando hay objeciones debido a dependencias irremplazables de terceros que están atrapadas en el limbo y vinculadas a ciertas versiones de ciertas plataformas.
Para los servicios, sospecho que es posible que desee ver un período de seis meses o un año, simplemente debido a la variación de quién y cómo se puede consumir un servicio, y la variación correspondiente del ciclo de desarrollo de proyecto consumidor a proyecto consumidor: muchos proyectos que podrían estar consumiendo su servicio aún podrían tener un gran diseño inicial y pueden programar un ciclo de lanzamiento de más de un año. La mayoría de las opiniones de los desarrolladores desde el exterior sugerirían que aquellos con cronogramas largos son responsables de cumplir con los tiempos de su ciclo, y esos proyectos que consumen un ciclo largo deberían adoptar un ciclo de lanzamiento más rápido, y puede ser cierto. Pero, en última instancia, la fecha de eliminación es algo que debe negociar con los usuarios.
Una buena estrategia de desaprobación, pero no a prueba de balas, podría ser al anunciar la desaprobación, resaltar el plazo para la intención de eliminar, junto con una solicitud de comentarios u objeciones en un formato de encuesta de las secciones de la API en cuestión. Si no tiene una lista de contactos de usuarios porque su servicio funciona con acceso [semi] anónimo, puede considerar buscar registros para usuarios frecuentes y activos y enviar la notificación al host o administrador de dominio para que la reenvíe como mejor le parezca.