在评论中纠正第三人称单数的正确方法

Question

我知道这是一个奇怪的问题，但我最近对此感到困惑。

我一直在寻找github中的一些存储库，这两种方法似乎都在实践中使用。那么，在这种模式中用英语语法写出评论的正确方法是什么？

// create an integer to store the sum.
int i = 1 + 1;

// creates an integer to store the sum.
int i = 1 + 1;

Answer 1

Google's style guide 建议使用第三人称而不是命令式。

Recommended: tasks.insert: Creates a new task on the specified task list.
Not recommended: tasks.insert: Create a new task on the specified task list.

您的问题可能与 this one 重复，因此请查看那边。我想，最后，这取决于您的个人喜好，无论您使用命令式还是第三人称。这也反映在链接问题的不同意见中。只要在您的项目/组织内保持一致，一切都会好起来的。