請推薦一個開放源代碼的項目，並提供優質的英語評論

Question

英語不是我的母語。但是，我必須用英文撰寫評論。我想通過學習一段以良好英語評論的代碼來提高我的「評論英語」。請推薦一個開放源代碼項目，其中包含由具有良好語言指令的人編寫的許多有意義的評論。

Answer 1

我可以推薦Simon Tatham的拼圖集合。

我讀過的評論對我來說看起來像是正確的英語。此外，它們的寫法清晰，並且包含有關爲什麼事情按照原樣完成的有用信息。

開發者文檔也很容易閱讀和理解，作爲一個副作用，您將閱讀具有良好和簡單體系結構的系統文檔。

如果你的目標是讀一些東西然後模仿它而不明確地理解爲什麼這樣做是一個好主意，那麼我絕對可以推薦ST的謎題。如果你想明確理解什麼是好寫作，我認爲ST的謎題將成爲一個很好的示例，但是你確實想要讀一些像Strunk和White這樣的東西。

Answer 2

我不認爲評論是學習的好地方，即使你必須模仿這種風格。意見往往不是正確的英語和良好的項目不會有太多的意見，因此，沒有太多的學習。

另一方面，如果你接受一個廣泛評論的項目，你幾乎可以肯定它不是一個好的榜樣，因爲程序員不能傳達簡潔的意思。當然這是一個泛化。但是，我相信它（幾乎？）總是如此。因人而異。

相反，通過學習專家來學習英語。有關於此的a question。我建議「On Writing Well」 by William Zinsser，我會再次這樣做。

（順便說一下，英語不是我的母語無論是。）

Answer 3

我永遠只能看着小片的，但我聽到的Linux內核是很好的註釋。

Answer 4

我一直以爲Angband的評論很好。

Answer 5

我相當好的評論開源項目是Drupal。請在Drupal.org查看。我已經開發了幾個門戶網站，你可以通過閱讀模塊和主題中的評論來學習。事實上，他們有更多的信息，那麼文件。

Answer 6

Minix的評論很好。他們在某些地方可能有點簡潔，但評論非常有幫助。

Answer 7

此外，如果你想改善你的寫作...有很多關於英語的混淆事情。你如何掌握這些觀點，是一位平庸作家和一位優秀作家的區別。最好的，最小的，最簡潔的書（每個人都應該有一個副本！）叫做Elements of Style by Strunk and White。請注意，您可以在亞馬遜購買2美元。最好的$ 2你會花！