理,去除冗余信息,形成更為規(guī)范、易讀的制式文檔。
在信息管理當(dāng)中有一個(gè)基本原則,就是要在產(chǎn)生信息的地方收集信息才是最有效的。將文檔的形成過程分成記錄和整理兩個(gè)階段,用各種最方便的形式首先進(jìn)行記錄,這樣也是可以作為文檔滿足實(shí)際需要和各種質(zhì)量體系的要求,以后再經(jīng)過整理形成可供后人查閱的文檔,不必非要在緊張的開發(fā)項(xiàng)目過程中進(jìn)行文檔整理工作。
5、區(qū)分項(xiàng)目文檔與產(chǎn)品文檔
在文檔管理中,還經(jīng)常遇到項(xiàng)目文檔和產(chǎn)品文檔的問題。在軟件研發(fā)項(xiàng)目中,一個(gè)項(xiàng)目任務(wù)的完成,經(jīng)常需要多個(gè)軟件系統(tǒng)(產(chǎn)品)的共同配合,從而會(huì)形成項(xiàng)目與產(chǎn)品之間多對(duì)多的矩陣式管理關(guān)系,既要滿足項(xiàng)目管理的需要,又要滿足各系統(tǒng)的產(chǎn)品管理的需要。一般的經(jīng)驗(yàn)是,將針對(duì)單個(gè)系統(tǒng)的軟件需求、設(shè)計(jì)、編碼、測試的文檔作為產(chǎn)品文檔,作為相應(yīng)的軟件版本的配套文檔,反映軟件系統(tǒng)本身的變化過程,而將跨系統(tǒng)的業(yè)務(wù)需求、整體方案、聯(lián)調(diào)測試、聯(lián)合投產(chǎn)、項(xiàng)目管理等相關(guān)文檔作為項(xiàng)目文檔,作為與相應(yīng)業(yè)務(wù)需求和項(xiàng)目的配套文檔。這方面可以具體參考之前的短文《軟件研發(fā)項(xiàng)目中業(yè)務(wù)需求與應(yīng)用系統(tǒng)之間的矩陣化管理》。
6、經(jīng)得住事后審計(jì)
作為交付物的文檔,必須要能夠清晰記載各種事項(xiàng)的來龍去脈和因果關(guān)系,對(duì)于一些重要的決策要記錄其關(guān)鍵過程,也就是說,無論是從專業(yè)角度還是從管理角度,對(duì)于形成邏輯關(guān)系的關(guān)鍵內(nèi)容都要形成文檔記錄,不僅便于后續(xù)環(huán)節(jié)的理解,更要能夠經(jīng)得起事后的審計(jì)。所以,對(duì)于一些比較重要的技術(shù)類和管理類文檔,從事后審計(jì)的角度來審視文檔內(nèi)容,確實(shí)也是一個(gè)很好的視角。在很多單位當(dāng)中,一份邏輯嚴(yán)謹(jǐn)、經(jīng)得起審計(jì)的文檔,越來越重要。