Re: [討論] 案主應給什麼文件？

看板CodeJob (BBS架站)作者bobju (寶貝豬)時間16年前 (2008/12/29 13:08)推噓0(0推 0噓 4→)

留言4則, 2人參與討論串2/2 (看更多)

※ 引述《limoki (老莫)》之銘言： : 小弟並非程設師 : 但是可能是潛在的案主... : 請問各位大大在接案時 : 會希望案主給怎樣的文件嗎？案主需要做的最基本的是: 1. 把需求表達清楚, 以及 2. 其所期待的最終成品所需具備的功能. 文件化. 文件的確就是'根據', 沒有文件做根據, 只憑口頭交待, 最後通常都變成各說各話. 別說聽的人可能會有遺漏, 恐怕連說的人你要他重述他說過哪些話他都做不到, 那最後東西做出來若有爭議的話當然變成一場雞同鴨講的混戰. X( 不過即使是有受過訓練的人, 對於要把需求給表達清楚這樣的一件事做好也不簡單, 至於沒經驗的案主就更不用說了. 因為有些需求一開始只是一種'想要解決問題的感覺', 很抽象, 很雜, 而且要表達清楚還得依靠某些格式化的工具才行, 要具體化/清晰化到可以用文件來表示, 讓大家都能夠看得懂的過程當中其實還是需要下不少功夫. 沒經驗的案主是不懂得要將需求'文件化'這件事的重要性的, 而且未經訓練, 你要他把需求文件化對他來講是件苦差事, 他絕對辦不到. 所以有經驗的人需要負起主導的任務, 通常就是接案廠商囉. 透過需求訪談的流程, 做好記錄, 最後整理成文件, 交給案主確認, 雙方簽字同意, 成為有效的需求描述的文件. 有經驗的案主能夠事先提供需求描述文件那最好, 廠商看過後只要確認沒問題那就行了. 後面分析工作到開出功能規格書那是廠商的事. 至於功能描述文件, 原本是可以等廠商開出功能規格書後, 雙方再確認的. 不過案主也可以先描述他期待的功能, 請廠商在開出功能規格書的時候考慮進去. : 之所以這樣問，是希望屆時我在發包時 : 能夠盡量給出（當然要在我能力內）能幫助到工程師的文件我想你應該不是案主, 而是接案的人. :) 你從案主那邊接到案子, 根據需求描述文件開出功能規格書, 接著讓工程師根據功能規格書施工. 在這個階段, 工程師需要的就是功能規格書當中, 對於各個功能的實施的程序描述了, 程序描述可以使用自然語言. 你把程序描述開出來 , 工程師就照著功能內部的程序描述去做coding/debug/test等事.所以照這樣的流程寫出來的code, 絕對都有對應的註解(就是功能實施程序的描述), 因為註解就是寫程式碼的依據, 絕對不是先寫程式碼, 再寫註解(當然在寫程式碼後, 還是可以對註解補遺). 後面的人若要接手維護,是比較好維護的. : 因為我從公司的經驗看到太多光靠「口頭」溝通而fail掉的專案了 : 您會希望案主給的文件中 : 能夠盡量有哪些內容，才能提高設計與開發的品質 : 並減少中間的溝通落差 : 謝謝大家（也期待不久後有機會跟大大們合作） -- ※ 發信站: 批踢踢實業坊(ptt.cc) ◆ From: 59.104.188.17 ※ 編輯: bobju 來自: 59.104.188.17 (12/29 13:14) ※ 編輯: bobju 來自: 59.104.188.17 (12/29 13:18)