作者MasterChang (我愛ASM)
看板Programming
標題Re: [請益] 程式該怎麼越寫越好呢
時間Sat Sep 26 21:19:24 2009
※ 引述《ji3g45j (pig)》之銘言：
: ※ 引述《tylpk (tylpk)》之銘言：
: : 自己的程式更是想到就寫註解
: : 即使從該 function 的註解就可以知道用途
: : 我還是會在呼叫的地方再寫一次
: : 我可不想以後想修改自己的程式
: : 還要回頭想老半天
: : 時間是很寶貴滴 ~
: 寫足夠的注解是必要的，但是當需要大篇文章才能描述出複雜的情境
: 去了解一堆程式碼的時候，就需要考慮看看是不是思考方向錯誤
: 或是需要分解出一些function來減低複雜度
不知道各位在寫code的時間佔專案的比重視多少？以自己做
專案的經驗來說，大概有 1/2時間在寫文件。註解？那也要
知道你要找的位置才有用。註解很重要沒錯，有一份好的文
件帶你總觀整個程式，找到你要看的註解更重要。
我不是待軟體公司，不太瞭解軟體公司在專案管理上是怎樣
做，但是按照「正常」的作法，應該文件這塊是滿重要的。
尤其團隊成員有異動時，可以讓新成員快速進入狀況，而不
是把code丟給他自己K ，尤其自己做的專案，軟硬體耦合程
度頗高，這不是叫對方去死死算了。
而且軟體組有時兩三個在搞，硬體組可能也是兩三個人再搞
，文件不寫好，很難做專案會議的。更不要講去管制進度。
--
※ 發信站: 批踢踢實業坊(ptt.cc)
◆ From: 118.232.3.100
1F：→ airzone:寫文件一定要帶專案的人強力要求，不然很 218.169.90.41 09/26 22:01
2F：→ airzone:多人你跟他說他只會敷衍帶過。 218.169.90.41 09/26 22:03
3F：推 ji3g45j:公司要把文件當做績效一部分才行 218.173.100.90 09/26 22:53
4F：推 ast9869:文件很重要，有幾個人能真正落實呢~~煙123.110.224.134 09/27 00:21
5F：→ ast9869:當專案越來越大，業務邏輯複雜度提升，123.110.224.134 09/27 00:22
6F：→ ast9869:註解就越來越不敷使用了~123.110.224.134 09/27 00:24
7F：推 ast9869:z123.110.224.134 09/27 03:20
8F：→ ykjiang:團隊間的溝通，文件的確很重要 61.230.65.65 09/28 12:37