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

Question

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

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

// 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 重复，所以请看那里。我想，最终，这取决于您的个人喜好，无论您使用命令式还是第三人称。这也反映在链接问题中的不同意见。只要在您的项目/组织中保持一致，一切都很好。