En este caso específico, es un error en una API de una biblioteca utilizada internamente que usan otros desarrolladores.
Si esos otros desarrolladores pensaron que el comportamiento era una característica, es probable que lo hayan usado y hayan desarrollado software de trabajo sobre él. La corrección del error probablemente romperá su código existente, y te culparán por esto. Esto hace que arreglar el error sea una compensación, y debes considerar
¿Es realmente importante corregir el error, por ejemplo, porque existe un alto riesgo de permitir que los usuarios de su API bloqueen sus aplicaciones en caso de que el error no se solucione? ¿O se trata solo de la coherencia de la API?
¿O es más importante mantener estable el software existente y su biblioteca compatible con versiones anteriores?
La respuesta a la pregunta no siempre es simple, debe tener en cuenta el número de posibles usuarios de su API, la cantidad potencial de trabajo que tendrán que cambiar su software, la cantidad de software que se romperá si cambia su API , pero también los riesgos de lo que podría suceder si no arregla la API.
El hecho de que documente el cambio de corrección de errores en una "lista de cambios importantes en su próxima versión principal" no hace felices a sus clientes; si lo hace, debería haber al menos algún razonamiento a prueba de balas por el que no podía dejar que la API funcionara. Fue antes. A menudo, mantener la compatibilidad con versiones anteriores es más importante que corregir un error. Así que corríjalo solo si puede estimar el impacto en su base de usuarios y su software y está seguro de que no va a producir esfuerzos irrazonables para ellos cuando intenten actualizar a su última versión de la biblioteca. Y si no tiene suficiente información para hacer una buena estimación de esto, probablemente sea mejor no cambiar el comportamiento.
(Y sí, si va a hacer un cambio de API que no sea compatible con versiones anteriores, sus números de versión deben expresarlo claramente, no importa si lo llama "corrección de errores" o no).