精力,看文檔的人不知所云,故只有高質(zhì)量的、必要的文檔才是我們所需要的。
既然文檔這么重要,一定有人會(huì)問(wèn):如何寫(xiě)好文檔呢?這個(gè)就是接下來(lái)要談的問(wèn)題。
大家在寫(xiě)文檔的時(shí)候,肯定會(huì)為從哪里寫(xiě)起、文檔的結(jié)構(gòu)怎么定、具體寫(xiě)哪些內(nèi)容等發(fā)愁,這就需要企業(yè)建立起自己的組織過(guò)程資產(chǎn)庫(kù),提供模板和樣例。文檔模板規(guī)定了該類(lèi)文檔的組織結(jié)構(gòu)、主要內(nèi)容、模式要求等;樣例提供文檔編寫(xiě)的范例與參考。當(dāng)然,文檔的模板不是拍腦袋弄出來(lái)的,是來(lái)源于實(shí)際項(xiàng)目,并參考了業(yè)界的一些最佳作法,然后到具體項(xiàng)目中使用再修訂最后才訂搞,后續(xù)不斷優(yōu)化改進(jìn);樣例則是模板在實(shí)際產(chǎn)品開(kāi)發(fā)項(xiàng)目中使用的結(jié)果。
再就是,組織過(guò)程資產(chǎn)庫(kù)中發(fā)布的文檔模板是比較全面和系統(tǒng)的,那么在一些實(shí)際項(xiàng)目中就會(huì)有自己的特點(diǎn),可能不需要提供項(xiàng)目每個(gè)階段所有的文檔,可能編寫(xiě)的文檔內(nèi)容不需要包括文檔模板中所有的內(nèi)容,這種情況可以根據(jù)實(shí)際情況裁減,提供裁減指南。
隨著信息技術(shù)的發(fā)展,項(xiàng)目中的很大一部分文檔通過(guò)一些工具和管理系統(tǒng)反映出來(lái),像一些建模工具、項(xiàng)目管理系統(tǒng)、需求管理系統(tǒng)等,但這些都是文檔的另一種表現(xiàn)形式,很多編寫(xiě)的工作通過(guò)工具和系統(tǒng)自動(dòng)化處理,從而很大程度上提高的編寫(xiě)文檔的速度與質(zhì)量,同時(shí)大大提高了效率。
不管如何,我們要意識(shí)到寫(xiě)文檔的重要性和必要性,并養(yǎng)成編寫(xiě)好文檔的習(xí)慣。