У цьому конкретному випадку це помилка в API бібліотеки, що використовується внутрішньо, а також інші розробники.
Якщо ті інші розробники вважали, що поведінка є особливістю, цілком ймовірно, що вони використали її та створили на ній працююче програмне забезпечення . Виправлення помилки, ймовірно, порушить їх існуючий код, і вони будуть звинувачувати вас у цьому. Це робить виправлення помилки компромісом, і вам доведеться врахувати
чи дійсно важливо виправити помилку, наприклад, тому що існує високий ризик дозволити користувачам вашого API збій свої програми, якщо помилка не виправлена? Або мова йде лише про узгодженість API?
чи важливіше зберегти існуюче програмне забезпечення стабільним, а вашу бібліотеку назад сумісною?
Відповідь на питання не завжди проста, ви повинні врахувати кількість можливих користувачів вашого API, потенційну кількість роботи, яку їм доведеться змінити програмне забезпечення, кількість програмного забезпечення, яке порушиться, якщо змінити API , а також ризики того, що може статися, якщо не виправити API.
Тільки тому, що ви задокументуєте зміну помилки у "списку порушення змін у вашому наступному головному випуску", це не робить ваших клієнтів щасливими - якщо ви це зробите, має бути принаймні кілька примірників міркувань, чому ви не могли дозволити API як такий був раніше. Часто збереження зворотної сумісності важливіше, ніж виправлення помилки. Тому виправте це лише в тому випадку, якщо ви зможете оцінити вплив на свою базу користувачів та їх програмне забезпечення, і ви впевнені, що не збираєтеся докладати для них необгрунтованих зусиль, намагаючись оновити до останнього випуску бібліотеки. І якщо у вас не буде достатньо інформації, щоб зробити гарну оцінку з цього приводу, можливо, краще буде не змінювати поведінку.
(І так, якщо ви збираєтесь змінити API, який не є сумісним назад, номери версій повинні це чітко виражати, не важливо, називаєте ви це "помилкою" чи ні).