Release-Notes 编写规范

每次版本发布前,需要由发布经理或则开发者,整理好本次版本的release-notes,来简要地描述了新版本更新中包含的特定更改。

为保持统一和方便编写,制定如下规范:

  • 需要有版本的总结,几句话总结性的描述本版本的核心主要变动点
  • 按变化的功能点 以 新特性/增强点/修复功能/其他 四大类进行分类罗列
  • 包含致谢栏:有参与本此版本贡献的同学,除了issue/pr外,以及任何参与到此次版本讨论/社群答疑/意见建议的同学
  • 每条note的规范:[服务名缩写-L1 maven module名][Linkis-pr/issues序号] 本次变动简要描述信息,能通过描述信息,大体知道这个功能的变化 [服务名缩写-L1 maven module名]作为一个标签,示例如下
  • 同一类别(新特性/增强点/修复功能/其他)下, 服务名相同的放在一起,按pr/issues序号升序排列
  • 需要有对应的英文文档
  1. 服务名缩写:此pr的变动,在代码层面上,主要归属的服务对应的服务名缩写
  2. 比如某pr是对JDBC引擎做了bug修复,在代码层面上,它是linkis-cg-engineconn 服务下的JDBC模块
  3. EG:[EC-Jdbc][[Linkis-1851]](https://github.com/apache/linkis/issues/1851) 修复jdbc引擎,一次任务执行中存在多条sql语句时无法正常执行的问题
  4. L1 maven module 不存在,或则是整个服务级别的调整,下级模块可以不写,比如Entrance
  1. linkis-mg-eureka Eureka
  2. linkis-mg-gateway Gataway
  3. linkis-cg-linkismanager LM
  4. linkis-cg-engineconnplugin ECP
  5. linkis-cg-engineconnmanager ECM
  6. linkis-cg-engineconn EC
  7. linkis-cg-entrance Entrance
  8. linkis-ps-publicservice PS
  9. linkis-ps-cs CS
  10. linkis-ps-metadatamanager MDM
  11. linkis-ps-data-source-query DSQ
  12. Web管理台 Web
  13. 安装 Install
  14. 安装-脚本 Install-Scripts
  15. 安装-SQL Install-Sql
  16. 安装-Web Install-Web
  17. 公共模块 Common