有什么自动生成 CHANGELOG 的好方式吗? - V2EX
V2EX = way to explore
V2EX 是一个关于分享和探索的地方
现在注册
已注册用户请  登录
git
Pro Git
Atlassian Git Tutorial
Pro Git 简体中文翻译
GitX
x97bgt
V2EX    git

有什么自动生成 CHANGELOG 的好方式吗?

  •  
  •   x97bgt 2021-09-22 18:36:06 +08:00 5307 次点击
    这是一个创建于 1530 天前的主题,其中的信息可能已经有所发展或是发生改变。

    release 时的 CHANGELOG 都是手写的,每次都要找 commit 历史找到发疯。有啥好的工具可以根据 commit 生成 CHANGELOG 的么?

    13 条回复    2021-09-26 15:23:04 +08:00
    anxn
        1
    anxn  
       2021-09-22 19:34:36 +08:00 via Android
    janxin
        3
    janxin  
       2021-09-22 20:46:47 +08:00 via iPhone
    git-chglog
    zthxxx
        4
    zthxxx  
       2021-09-22 22:08:35 +08:00   1
    nmgwddj
        6
    nmgwddj  
       2021-09-23 11:36:08 +08:00   1
    我对 CHANGELOG 的存在价值持怀疑态度。commits 信息已经足够可以描述修改历史了,为什么还需要一个 CHANGELOG ?
    如果你觉得 CHANGELOG 是给不同角色的人看的,那自动生成的内容往往也不能满足需求。一个 commit 的 title 80 个字符可以描述的内容及其有限,而 commit 的 description 内容又可能会非常多,更加不适合给非程序员的角色去看。
    所以,自动生成 CHANGELOG 的意义是什么?
    flniu
        7
    flniu  
       2021-09-23 13:15:24 +08:00
    https://keepachangelog.com/zh-CN/1.0.0/
    楼上说的有道理:更新日志绝对不应该是 git 日志的堆砌物
    indo
        9
    indo  
       2021-09-23 14:24:52 +08:00
    对于我这种 commit 都经常乱打的人,表示还是自己手动写 changelog 更合适吧。
    fml87
        10
    fml87  
       2021-09-23 14:50:10 +08:00
    自动生成有意义的 changelog 的前提是 commit 信息必须严格遵照特定的规范,感觉也就个人项目这么搞的成本低一些
    learningman
        11
    learningman  
       2021-09-23 15:14:08 +08:00
    semantic-release
    liziwl
        12
    liziwl  
       2021-09-23 23:17:40 +08:00
    @fml87 确实哈哈哈哈哈,commit 或者 changelog 总要认真写一个。像我 commit 随意写的,还是老实写 changelog 好了。
    nmgwddj
        13
    nmgwddj  
       2021-09-26 15:23:04 +08:00
    @KouShuiYu 多不代表就是对的、最佳的。做技术的人更要跳出这个思维模式,要考虑做这件事情的意义和价值。这样才不会盲目跟风做一些无意义产出。
    关于     帮助文档     自助推广系统     博客     API     FAQ     Solana     5072 人在线   最高记录 6679       Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 32ms UTC 09:33 PVG 17:33 LAX 01:33 JFK 04:33
    Do have faith in what you're doing.
    ubao msn snddm index pchome yahoo rakuten mypaper meadowduck bidyahoo youbao zxmzxm asda bnvcg cvbfg dfscv mmhjk xxddc yybgb zznbn ccubao uaitu acv GXCV ET GDG YH FG BCVB FJFH CBRE CBC GDG ET54 WRWR RWER WREW WRWER RWER SDG EW SF DSFSF fbbs ubao fhd dfg ewr dg df ewwr ewwr et ruyut utut dfg fgd gdfgt etg dfgt dfgd ert4 gd fgg wr 235 wer3 we vsdf sdf gdf ert xcv sdf rwer hfd dfg cvb rwf afb dfh jgh bmn lgh rty gfds cxv xcv xcs vdas fdf fgd cv sdf tert sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf sdf shasha9178 shasha9178 shasha9178 shasha9178 shasha9178 liflif2 liflif2 liflif2 liflif2 liflif2 liblib3 liblib3 liblib3 liblib3 liblib3 zhazha444 zhazha444 zhazha444 zhazha444 zhazha444 dende5 dende denden denden2 denden21 fenfen9 fenf619 fen619 fenfe9 fe619 sdf sdf sdf sdf sdf zhazh90 zhazh0 zhaa50 zha90 zh590 zho zhoz zhozh zhozho zhozho2 lislis lls95 lili95 lils5 liss9 sdf0ty987 sdft876 sdft9876 sdf09876 sd0t9876 sdf0ty98 sdf0976 sdf0ty986 sdf0ty96 sdf0t76 sdf0876 df0ty98 sf0t876 sd0ty76 sdy76 sdf76 sdf0t76 sdf0ty9 sdf0ty98 sdf0ty987 sdf0ty98 sdf6676 sdf876 sd876 sd876 sdf6 sdf6 sdf9876 sdf0t sdf06 sdf0ty9776 sdf0ty9776 sdf0ty76 sdf8876 sdf0t sd6 sdf06 s688876 sd688 sdf86