comments - 请推荐一个英文好的开源项目，有质量的评论

Question

英语不是我的母语。但是，我必须用英文写评论。我想通过研究一段用英语评论的代码来提高我的“评论英语”。请推荐一个开源项目，其中包含许多由精通该语言的人撰写的有意义的评论。

Answer 1

我可以推荐 Simon Tatham 的 Puzzle Collection。

我读过的评论对我来说似乎是正确的英语。此外，它们写得很清楚，包含有用的信息，说明事情为什么会这样。

开发人员文档也易于阅读和理解，作为附带好处，您将阅读具有良好和简单体系结构的系统文档。

如果您的目标是阅读某些内容然后模仿它而没有明确理解为什么这样做是个好主意，我绝对可以推荐 ST 的拼图。如果你想清楚地理解什么是好的写作，我认为 ST 的拼图将作为一个很好的例子，但你真的想阅读像 Strunk and White 这样的东西。