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