git
› Pro Git
› Atlassian Git Tutorial
› Pro Git 简体中文翻译
› GitX
x97bgt
V2EX  ›  git

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

  •  
  •   x97bgt · Sep 22, 2021 · 6234 views
    This topic created in 1877 days ago, the information mentioned may be changed or developed.

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

    13 replies  •  2021-09-26 15:23:04 +08:00
    anxn
    anxn
    Sep 22, 2021 via Android
    1
    janxin
    janxin
    Sep 22, 2021 via iPhone
    3
    git-chglog
    nmgwddj
    nmgwddj
    Sep 23, 2021❤️1
    6
    我对 CHANGELOG 的存在价值持怀疑态度。commits 信息已经足够可以描述修改历史了,为什么还需要一个 CHANGELOG ?
    如果你觉得 CHANGELOG 是给不同角色的人看的,那自动生成的内容往往也不能满足需求。一个 commit 的 title 80 个字符可以描述的内容及其有限,而 commit 的 description 内容又可能会非常多,更加不适合给非程序员的角色去看。
    所以,自动生成 CHANGELOG 的意义是什么?
    flniu
    flniu
    Sep 23, 2021
    7
    https://keepachangelog.com/zh-CN/1.0.0/
    楼上说的有道理:更新日志绝对不应该是 git 日志的堆砌物
    indo
    indo
    Sep 23, 2021
    9
    对于我这种 commit 都经常乱打的人,表示还是自己手动写 changelog 更合适吧。
    fml87
    fml87
    Sep 23, 2021
    10
    自动生成有意义的 changelog 的前提是 commit 信息必须严格遵照特定的规范,感觉也就个人项目这么搞的成本低一些
    learningman
    learningman
    Sep 23, 2021
    11
    semantic-release
    liziwl
    liziwl
    Sep 23, 2021
    12
    @fml87 确实哈哈哈哈哈,commit 或者 changelog 总要认真写一个。像我 commit 随意写的,还是老实写 changelog 好了。
    nmgwddj
    nmgwddj
    Sep 26, 2021
    13
    @KouShuiYu 多不代表就是对的、最佳的。做技术的人更要跳出这个思维模式,要考虑做这件事情的意义和价值。这样才不会盲目跟风做一些无意义产出。
    About   ·   Help   ·   Advertise   ·   Blog   ·   API   ·   FAQ   ·   Privacy   ·   Solana   ·   4761 Online   Highest 6679   ·     Select Language
    创意工作者们的社区
    World is powered by solitude
    VERSION: 3.9.8.5 · 40ms · UTC 03:33 · PVG 11:33 · LAX 19:33 · JFK 22:33
    ♥ Do have faith in what you're doing.