Skip to content

版本号策略

Liam Huang edited this page May 31, 2016 · 2 revisions

当你发布新版本的时候,请遵循此版本号策略。

天字第一号原则

每次发布,都必须修改(提升)版本号;不得与既有版本号重复或相对后退。

版本号的组成

sduthesis 版本号形如 v1.3.0a。其中:

  • v 是英文单词 version 的缩写,在版本号中总是处于第一位并以小写保持不变;
  • 1 是一级版本号(主版本号),阿拉伯数字;
  • 3 是二级版本号(次版本号),阿拉伯数字,与主版本号之间用西文句点 . 分割开来;
  • 0 是三级版本号,阿拉伯数字,与次版本号之间用西文句点 . 分割开来;
  • a 是附属位,小写英文字母,并不总是出现;若出现,则紧邻三级版本号。

版本号升级策略

本节阐述各级版本号何时升级。

主版本号

主版本号应该相对最稳定,最少变动:只有当 sduthesis 作出重大改动(代码或功能上的)时,或用户需要完全地重新适应新的接口时,才升级主版本号。

次版本号

次版本号相对三级版本号稳定,较少变动:在不须变动主版本号的情况下,只有当 sduthesis 作出较大改动(代码或功能上的)时,或用户需要简单地改变以适应新的接口时,才升级次版本号。

三级版本号

三级版本号相对不稳定:在不须变动主、次版本号的情况下,当 sduthesis 作出较小调整(代码或功能上,通常 bugfix 以及例行版式更新属于此类)时,应当升级三级版本号。

附属位

附属位仅供开发者「急救」使用。使用附属位,通常意味着先前发布的代码出现了一个可修复也可不修复的问题,但往往修复了会更加完美。比如:

  • 发现某处 LaTeX 错误拼写成了 LaTex——当然,这种错误希望永远不要发生;
  • 发现文档某处措辞稍事修改能更加妥当。

简单说,附属位只有完美主义者的强迫症发作时,才会被启用。(笑)