当财产变得过时时如何对待semver

时间:2017-11-28 10:49:38

标签: javascript css semantic-versioning

我们正在为我们的CSS库使用semver,请确保关注如何对其进行版本化的官方guidelines

但是,每当我们制作一个类(或者在JS的情况下 - 属性或参数)过时 - 我们应该怎么做?客户端可以将其从标记/函数调用中删除,但实际上不必。

什么是正确的版本?

  • 一个补丁,因为你真的不需要做任何消费者的事情吗?
  • 未成年人,因为你可以清理你的代码?
  • 一个主要的甚至,因为API改变了,虽然是可选的,但消费者应该清理它的代码。

1 个答案:

答案 0 :(得分:2)

根据我对你的案例的理解,你应该将过时的类标记为deprecated,这将导致第7点所写的次要版本的增加:

  
      
  1. 如果向公共API引入了新的向后兼容功能,则必须增加次要版本Y(x.Y.z | x> 0)。 如果任何公共API功能被标记为已弃用,则必须递增。如果在私有代码中引入了大量新功能或改进,则可以递增。它可能包括修补程序级别更改。当次要版本增加时,补丁版本必须重置为0。
  2.