Skip to main content

One post tagged with "git"

View All Tags

CL描述是一个公开的记录,说明正在进行修订的变化和原因。它将成为我们版本控制记录的一个永久部分,并且有可能在近些年里被你的审查员以外的数百人阅读。 未来的开发者会根据它的描述来搜索你的CL。未来的人可能会因为对你的变化有微弱的记忆而寻找你的变化﹐但却没有方便的具体细节。如果所有的重要信息都是在代码中﹐而不是在描述中﹐他们要找到你的CL就会困难很多。

A CL description is a public record of what change is being made and why it was made. It will become a permanent part of our version control history, and will possibly be read by hundreds of people other than your reviewers over the years. Future developers will search for your CL based on its description. Someone in the future might be looking for your change because of a faint memory of its relevance but without the specifics handy. If all the important information is in the code and not the description, it's going to be a lot harder for them to locate your CL.

gitgithub5 min read