Difference between revisions of "彩云天气 API 的版本策略"

From Caiyun Wiki
Jump to: navigation, search
 
(21 intermediate revisions by the same user not shown)
Line 1: Line 1:
<graphviz renderer="neato" caption="Revision Status">
+
彩云天气 API 的版本支持 [https://semver.org/spec/v2.0.0.html Semantic Versioning 2.0.0]。
digraph status {
+
 
  rank="same";
+
一个版本的生命周期支持 alpha、beta、current、deprecated、unsupported 的状态变化。
  alpha [pos="10,0", width="1", height="5"];
+
[[Image:API Revision Lifecycle.jpeg|thumb|right|版本的生命周期]]
  beta [pos="20,0", width="1", height="5"];
+
 
  current [pos="30,0", width="1", height="5"];
+
==示例==
  supported [pos="40,0", width="1", height="5"];
+
 
  deprecated [pos="50,0", width="1", height="5"];
+
v2.3 在开发阶段会有如下两个阶段
  unsupported [pos="60,0", width="1", height="5"];
+
 
  alpha -> beta;
+
* 版本号 v2.3-alpha,状态 alpha,此时该版本的特性和变更没有最终确定
  beta -> current;
+
* 版本号 v2.3-beta,状态 beta,此时该版本的特性和变更最终确定,但仍需经过充分测试以达到稳定状态
  current -> supported;
+
 
  supported -> deprecated;
+
正式上线后,
  deprecated -> unsupported;
+
 
}
+
* 版本号 v2.3,状态 current,此时该版本为当前稳定版本,历史版本退出进入 deprecated 状态
</graphviz>
+
 
 +
当更新的版本 v2.4 上线后,
 +
 
 +
* 版本号 v2.3,状态 deprecated,此时该版本为不建议使用的状态
 +
 
 +
当该版本确定不再维护后
 +
 
 +
* 版本号 v2.3,状态 unsupported,此时该版本退出服务行列

Latest revision as of 13:21, 12 October 2018

彩云天气 API 的版本支持 Semantic Versioning 2.0.0

一个版本的生命周期支持 alpha、beta、current、deprecated、unsupported 的状态变化。

版本的生命周期

示例

v2.3 在开发阶段会有如下两个阶段

  • 版本号 v2.3-alpha,状态 alpha,此时该版本的特性和变更没有最终确定
  • 版本号 v2.3-beta,状态 beta,此时该版本的特性和变更最终确定,但仍需经过充分测试以达到稳定状态

正式上线后,

  • 版本号 v2.3,状态 current,此时该版本为当前稳定版本,历史版本退出进入 deprecated 状态

当更新的版本 v2.4 上线后,

  • 版本号 v2.3,状态 deprecated,此时该版本为不建议使用的状态

当该版本确定不再维护后

  • 版本号 v2.3,状态 unsupported,此时该版本退出服务行列