COMMENTING提交的最佳做法是什么?
一点背景.
我们的政策一直是评论你犯下的一切,但我们几个最近背叛反对这一想法.
评论所有内容的问题有两个方面,它的工作量更多,而且用处不大.以下是我们看到的问题:
它鼓励人们发表评论,涵盖已经在版本控制中的东西(即我改变了第42行做了等等).您可以比较以获得相同的信息!
或者,它会用无用的注释填充你的评论流,如果你想搜索评论,这将是一个巨大的痛苦.
这些事情中的任何一个都会增加很多时间,并且不会增加任何价值.评论仅在它们具有足够的特定性且足够稀少以便您可以扫描所有内容时才有用.
我们被告知Git以比Subversion更聪明的方式处理这个问题,我们对变化持开放态度,显然拥有本地开发环境并且只提交批量更改也会有所帮助,但基于我们的用例可能会有所改变.效率方面的净损失.
我很想知道人们评论提交的最佳做法是什么,感谢任何反馈!