2011-06-12 85 views
0

我有一個簡單的問題。我是c#的新手,我想知道是否將作者放入.cs類。到目前爲止,我已經看到只有摘要和標題註釋放在那裏。在c#中評論

+2

這是個人喜好的問題,真的。 – 2011-06-12 18:32:49

+5

Quote:'如果這段代碼有效,它是由Paul DiLascia編寫的。如果沒有,我不知道是誰寫的' – 2011-06-12 18:37:06

回答

3

這裏確實沒有正確或錯誤的答案 - 這歸結於公司政策/您的偏好。在我看來,不過,這是不必要的,原因有二:

  • 源控制告訴你這些信息
  • 不止一個開發者可以在任何一個文件
+0

源代碼管理主要是使「最後修改」和「最後修改者」無效(但是男孩,它使它們無效!)。對於原作者,主要開發人員或維護人員來說,它可能有更多優點。 – delnan 2011-06-12 18:34:22

0

的發展涉及使用一個源代碼管理系統,把作者作爲評論是完全不相干的。源代碼管理系統可以幫助您將最新更改的人員分配給每一行。

如果您不使用源代碼控制或在網上發佈代碼,評論可能是合適的。

0

如果代碼庫是共享的,沒有什麼比單個作者更好的了。如果您有任何源代碼管理,它將負責將每個編輯信息與用戶相關聯。這是一個更好的方法,比頂部有作者姓名並在他/她觸摸該文件時附加每個作者姓名。

0

我會說,如果您要發佈代碼,並且您編寫了代碼,可能有某人的更新,您將您作爲作者,併爲更新/更正/錯誤修復添加備註。

如果它的內部,這不應該是必要的,因爲源代碼控制會照顧到這一點,而在內部它不太重要,試圖說「這是我的」。