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