從開源項目看python代碼註釋

最近看了不少代碼，也寫了不少代碼，所以在看和寫之間發現了很多的問題，真的是很多，至少從我的認識來看，有幾個地方有很大的改進空間，這裏不準備把所有的問題都列舉出來，所以就先挑選一個比較明顯得來和大家聊聊。回顧流行開源項目的成功，除了功能上的剛需之外，文檔也是必不可少的一個環節，沒有良好文檔的開源項目幾乎不可能說是流行的，因爲很少人會因爲你說了一句使用我的項目就可以怎麼怎麼樣就傻不溜秋得用你的。從我以

>>阅读原文<<