Re: [請益] 程式該怎麼越寫越好呢

[MasterChang (我愛ASM)]

※ 引述《ji3g45j (pig)》之銘言：
: ※ 引述《tylpk (tylpk)》之銘言：
: : 自己的程式更是想到就寫註解
: : 即使從該 function 的註解就可以知道用途
: : 我還是會在呼叫的地方再寫一次
: : 我可不想以後想修改自己的程式
: : 還要回頭想老半天
: : 時間是很寶貴滴 ~
: 寫足夠的注解是必要的，但是當需要大篇文章才能描述出複雜的情境
: 去了解一堆程式碼的時候，就需要考慮看看是不是思考方向錯誤
: 或是需要分解出一些function來減低複雜度

        不知道各位在寫code的時間佔專案的比重視多少？以自己做
        專案的經驗來說，大概有 1/2時間在寫文件。註解？那也要
        知道你要找的位置才有用。註解很重要沒錯，有一份好的文
        件帶你總觀整個程式，找到你要看的註解更重要。

        我不是待軟體公司，不太瞭解軟體公司在專案管理上是怎樣
        做，但是按照「正常」的作法，應該文件這塊是滿重要的。
        尤其團隊成員有異動時，可以讓新成員快速進入狀況，而不
        是把code丟給他自己K ，尤其自己做的專案，軟硬體耦合程
        度頗高，這不是叫對方去死死算了。

        而且軟體組有時兩三個在搞，硬體組可能也是兩三個人再搞
        ，文件不寫好，很難做專案會議的。更不要講去管制進度。

--
※ 發信站: 批踢踢實業坊(ptt.cc) 
◆ From: 118.232.3.100
→ airzone:寫文件一定要帶專案的人強力要求，不然很
→ airzone:多人你跟他說他只會敷衍帶過。
推 ji3g45j:公司要把文件當做績效一部分才行
推 ast9869:文件很重要，有幾個人能真正落實呢~~煙
→ ast9869:當專案越來越大，業務邏輯複雜度提升，
→ ast9869:註解就越來越不敷使用了~
推 ast9869:z
→ ykjiang:團隊間的溝通，文件的確很重要