小编use*_*960的帖子

提交代码时多久发表一次评论?

COMMENTING提交的最佳做法是什么

一点背景.

  • 我们所有的项目都使用版本控制(Subversion/SVN/Git),
  • 他们中的大多数都被2个或更多开发人员所感动,
  • 我们使用Springloops来托管我们的版本控制,因为它"正常工作"并且比内部开发人员维护它更为干净,
  • 因为我们的许多客户都有特殊的设置,并且因为它为多个用户设置这些环境的工作,我们很少打扰本地开发环境.大多数客户在云中具有开发位置,然后是实时位置.Springloops配置为自动将每个提交推送到开发服务器,并且开发人员必须手动推送到实时位置.

我们的政策一直是评论你犯下的一切,但我们几个最近背叛反对这一想法.

评论所有内容的问题有两个方面,它的工作量更多,而且用处不大.以下是我们看到的问题:

  1. 它鼓励人们发表评论,涵盖已经在版本控制中的东西(即我改变了第42行做了等等).您可以比较以获得相同的信息!

  2. 或者,它会用无用的注释填充你的评论流,如果你想搜索评论,这将是一个巨大的痛苦.

    • IE8的保证金问题
    • 另一个解决IE8边缘的问题
    • 恢复最后一次修复并在IE8中尝试使用保证金

这些事情中的任何一个都会增加很多时间,并且不会增加任何价值.评论仅在它们具有足够的特定性且足够稀少以便您可以扫描所有内容时才有用.

我们被告知Git以比Subversion更聪明的方式处理这个问题,我们对变化持开放态度,显然拥有本地开发环境并且只提交批量更改也会有所帮助,但基于我们的用例可能会有所改变.效率方面的净损失.

我很想知道人们评论提交的最佳做法是什么,感谢任何反馈!

svn git comments commenting

4
推荐指数
1
解决办法
291
查看次数

标签 统计

commenting ×1

comments ×1

git ×1

svn ×1