Как лечить семвер, когда свойство устаревает

1

Мы используем semver для наших CSS-библиотек, следим за тем, чтобы следовать официальным рекомендациям относительно их версии.

Однако, когда мы делаем класс (или в случае JS - свойство или аргумент) устаревшим - что нам делать? Клиент может удалить его из своих разметки/вызовов функций, но не обязательно.

Какая была бы правильная версия?

  • Патч, потому что вам действительно не нужно ничего делать как потребитель?
  • Минор, потому что вы МОЖЕТЕ очистить свой код?
  • Важнейшим даже, потому что API изменился, хотя и необязательный, но потребитель ДОЛЖЕН очистить свой код.
Теги:
semantic-versioning

1 ответ

2
Лучший ответ

По моему пониманию вашего дела вы должны отметить устаревший класс как deprecated и это приведет к увеличению младшей версии, как указано в пункте 7:

  1. Незначительная версия Y (xYz | x> 0) ДОЛЖНА быть увеличена, если новая открытая совместимая функциональность будет введена в открытый API. Он ДОЛЖЕН увеличиваться, если какая-либо общедоступная функциональность API отмечена как устаревшая. Он МОЖЕТ быть увеличен, если в частном коде появятся существенные новые функциональные возможности или улучшения. Он МОЖЕТ включать изменения уровня патча. Версия патча ДОЛЖНА быть сброшена на 0, когда малая версия увеличивается.

Ещё вопросы

Сообщество Overcoder
Наверх
Меню