В данном конкретном случае это ошибка в API библиотеки, используемой внутри, которую используют другие разработчики.
Если эти другие разработчики считали, что поведение является функцией, вероятно, они использовали ее и создали на ней работающее программное обеспечение . Исправление ошибки, вероятно, сломает их существующий код, и они обвинят вас в этом. Это делает исправление ошибки компромиссом, и вы должны учитывать
действительно ли важно исправить ошибку, например, потому что существует высокий риск того, что пользователи вашего API могут аварийно завершить работу своих приложений, если ошибка не исправлена? Или это только о согласованности API?
или важнее сохранить стабильность существующего программного обеспечения и обратную совместимость вашей библиотеки?
Ответ на этот вопрос не всегда прост: вы должны принять во внимание количество возможных пользователей вашего API, потенциальный объем работы, который им потребуется для изменения своего программного обеспечения, количество программного обеспечения, которое сломается, если вы измените свой API но также и риски того, что может случиться, если вы этого не сделаете исправите API.
Только то, что вы документируете изменение исправления в «списке критических изменений в вашем следующем основном выпуске», не делает ваших клиентов счастливыми - если вы это сделаете, должны быть хотя бы некоторые пуленепробиваемые доводы, почему вы не могли бы позволить API так был раньше. Часто сохранение обратной совместимости важнее, чем исправление ошибки. Так что исправляйте это, только если вы можете оценить влияние на вашу пользовательскую базу и их программное обеспечение, и вы уверены, что не будете предпринимать необоснованные усилия для них, когда они попытаются обновить вашу последнюю версию библиотеки. И если у вас недостаточно информации, чтобы составить точную оценку, вероятно, лучше не менять поведение.
(И да, если вы собираетесь внести изменение в API, которое несовместимо с предыдущими версиями, ваши номера версий должны это четко выражать, независимо от того, назовете вы это «исправлением» или нет).