→ pttworld: 有些人是先寫逐行註解，再把程式碼填上去 12/30 08:21
※ 引述《sec5566 (sec)》之銘言：
: 以前上課跟書本都提到寫註解，
: 但是我看資深同事還有接手的程式碼，
: 都沒有註解，只有我在寫，
: 還被主管念過寫註解沒必要，
: 命名好就夠了，
: 是我觀念落伍了嗎？
: -----
: Sent from JPTT on my Sony H4331.
這系列的文章討論下來的節奏很奇怪
要不要寫註解聽起來只是單個議題
但應該是有很多個面向的
例如註解的長短、閱讀的對象
不同的角度討論的內容就不一樣
像是同個team高手寫的code要給高手看
我想不加註解應該OK反正都是高手
如果是高手寫給新手看
我想加點註解是好的
新來的總是需要多點關照((?
但新手寫的code不加註解
我想讀起來是費力了點
還有像是常見Framework都有註解
畢竟有眾多面向的user
我想閱讀註解的門檻還是比較低一點
要一口氣就能寫出程式即註解的
還蠻需要一點功力的
然而要能夠寫出好註解
也是很需要功力的
不論是好的程式邏輯或是好的註解
目的都是為了讓別人或自己讀code更輕鬆
我覺得作為一個資訊人
這兩種做法都應該試著去練習
畢竟不同環境有不同的做法
若是會的更多，機會自然更多
-----
Sent from JPTT on my Asus ASUS_Z01HDA.
--
※ 發信站: 批踢踢實業坊(ptt.cc), 來自: 223.137.208.45
※ 文章網址: https://www.ptt.cc/bbs/Soft_Job/M.1546114375.A.F02.html