IT軟件項目文檔管理第10章

IT軟件項目文檔管理第10章第10章IT軟件項目文檔管理

10.1軟件項目文檔管理概述10.2項目文檔的質(zhì)量10.3項目文檔準(zhǔn)備10.4主要項目文檔2024/1/20210.1軟件項目文檔管理概述

10.1.1項目文檔管理的概念10.1.2項目文檔的分類10.1.3過程文檔10.1.4產(chǎn)品文檔2024/1/20310.1.1項目文檔管理的概念

能作為開發(fā)組員之間交流溝通的媒介。能為軟件項目的維護(hù)工程師提供有關(guān)信息系統(tǒng)的資料和知識庫。能為項目管理者提供項目計劃、預(yù)算、開發(fā)進(jìn)度等各方面的信息。能作為最終用戶或管理員的用戶手冊，使用戶知道如何使用、維護(hù)及管理系統(tǒng)。2024/1/204與軟件項目相關(guān)的項目文檔的概念屬性有：軟件項目文檔是IT軟件項目開發(fā)中的重要組成部分。文檔對于項目開發(fā)的成功和項目的正常維護(hù)起著重要的保證和支持作用。一般：文檔數(shù)量的多少、規(guī)模的大小、結(jié)構(gòu)的復(fù)雜程度與所開發(fā)軟件的大小和復(fù)雜程度成正比。10.1.2項目文檔的分類過程文檔：是指那些記錄軟件項目開發(fā)和維護(hù)過程的文檔資料，項目的計劃、進(jìn)度、過程質(zhì)量、組織及項目標(biāo)準(zhǔn)等都是過程文檔。產(chǎn)品文檔：是那些描述正在開發(fā)的產(chǎn)品的資料。這類文檔又可以分為從軟件工程師開發(fā)和維護(hù)系統(tǒng)的角度描述產(chǎn)品的系統(tǒng)文檔，以及主要以客戶為對象描述產(chǎn)品的用戶文檔。編寫過程文檔的主要目的在于所開發(fā)的產(chǎn)品能被很好地管理。產(chǎn)品文檔一般在系統(tǒng)運(yùn)行后才開始使用，同時它也對管理系統(tǒng)開發(fā)工作必不可少。不同時期編寫的文檔代表在軟件開發(fā)過程中的一個重要階段里程碑。2024/1/205文檔可分為以下兩大類，即過程文檔和產(chǎn)品文檔：10.1.3過程文檔（1）軟件項目計劃、預(yù)測和進(jìn)度安排文檔：這些文檔由項目經(jīng)理負(fù)責(zé)產(chǎn)生，以便預(yù)測和控制軟件的開發(fā)過程。相關(guān)報告：這些文檔用來報告在軟件開發(fā)過程中，資源是如何分配和利用的。標(biāo)準(zhǔn)報告：這些文檔規(guī)定了軟件過程應(yīng)該如何實(shí)現(xiàn)，這些可以是國際標(biāo)準(zhǔn)、國家標(biāo)準(zhǔn)、行業(yè)標(biāo)準(zhǔn)等。工作文檔：這些文檔是在項目開發(fā)中最主要的交流溝通工具，記錄了軟件項目開發(fā)中軟件工程師的想法等。備忘錄及電子信息：主要記錄了每天項目經(jīng)理和開發(fā)人員之間的詳細(xì)交流信息。2024/1/206過程文檔可以分為如下幾類：

10.1.3過程文檔（2）過程文檔的最大特點(diǎn)是：大部分文檔都是已經(jīng)過時了的。過程文檔主要是軟件項目開發(fā)過程中的各種事件和信息的記錄。在過程文檔中，計劃可以是由周計劃、日計劃或月計劃組成，進(jìn)度一般以周為單位進(jìn)行報告，記錄軟件工程師的想法和目的備忘錄將不斷被改變。大多數(shù)信息在過時后將沒有多少使用價值，一般也就沒有再保存的必要，但也有例外，如測試計劃等在軟件開發(fā)過程中具有保存的價值，它是系統(tǒng)變更的基礎(chǔ)；設(shè)計報告也具有保存的價值，它為維護(hù)系統(tǒng)提供依據(jù)等。2024/1/20710.1.4產(chǎn)品文檔（1）產(chǎn)品文檔主要描述已交付的軟件產(chǎn)品情況，與大多數(shù)過程文檔不同，產(chǎn)品文檔有很長的生命周期，它必須隨著產(chǎn)品一步步發(fā)展。產(chǎn)品文檔可以分為用戶文檔和系統(tǒng)文檔用戶文檔以文檔資料形式告訴用戶如何利用該系統(tǒng)；系統(tǒng)文檔主要為維護(hù)工程師服務(wù)。在軟件項目中，軟件的用戶并不完全相同，不同用戶面向的文檔也不一樣，因此，在編輯文檔時，必須將最終用戶和系統(tǒng)管理員區(qū)分開。最終用戶主要是使用軟件來完成一定的任務(wù)。他們只關(guān)心如何利用軟件來幫助他們完成工作，不關(guān)心計算機(jī)和軟件管理上其他細(xì)節(jié)。系統(tǒng)管理員負(fù)責(zé)管理最終用戶使用的軟件。2024/1/20810.1.4產(chǎn)品文檔（2）2024/1/209系統(tǒng)管理員向?qū)到y(tǒng)評估員功能性描述描述提供的服務(wù)系統(tǒng)管理員安裝描述怎樣安裝系統(tǒng)新用戶初級使用手冊如何開始使用系統(tǒng)老用戶參考手冊所有系統(tǒng)功能的詳細(xì)描述系統(tǒng)管理員如何操作和維護(hù)系統(tǒng)圖10.1需要隨軟件系統(tǒng)發(fā)布而產(chǎn)生的部分用戶文檔10.1.4產(chǎn)品文檔（3）——用戶文檔

系統(tǒng)功能描述：簡要描述系統(tǒng)的需求和提供的服務(wù)。該文檔為系統(tǒng)提供一個總體的概念描述。用戶通過閱讀該文檔，可以確定是不是他們所需要的系統(tǒng)。初級使用手冊：為系統(tǒng)提供一個非正式的介紹，描述一些“常規(guī)”的使用操作。系統(tǒng)參考手冊：描述系統(tǒng)的功能設(shè)施及其用途，能為錯誤信息提供一個完整的列表，并且描述怎樣從發(fā)現(xiàn)的錯誤中恢復(fù)。系統(tǒng)參考手冊應(yīng)該是完整的和正式的。系統(tǒng)安裝文檔：一般面向系統(tǒng)管理員，為系統(tǒng)管理員提供在特定環(huán)境下如何安裝系統(tǒng)的詳細(xì)說明。系統(tǒng)管理員手冊：主要提供當(dāng)系統(tǒng)與其他系統(tǒng)交互時所產(chǎn)生的信息，及如何對這些信息進(jìn)行反應(yīng)的說明。2024/1/201010.1.4產(chǎn)品文檔（4）——系統(tǒng)文檔系統(tǒng)文檔包括所有描述系統(tǒng)是如何從需求報告到最終變成可接受的系統(tǒng)過程中，與分析、設(shè)計、實(shí)施等方面有關(guān)的技術(shù)文檔。系統(tǒng)文檔主要包括：需求文檔及相關(guān)的基本原理說明。系統(tǒng)體系結(jié)構(gòu)文檔。對系統(tǒng)的每一個程序，都有相應(yīng)的程序體系結(jié)構(gòu)文檔。每個子系統(tǒng)的規(guī)范和設(shè)計說明書。程序代碼列表。這些列表包括程序注釋、用來解釋代碼中復(fù)雜代碼段和采用的編碼方法等。描述每個程序怎樣驗證和驗證信息與需求之間關(guān)系的驗證文檔。維護(hù)指導(dǎo)文檔，主要描述系統(tǒng)已知的問題、軟件支持、硬件支持等信息，以便維護(hù)時使用。2024/1/201110.2項目文檔的質(zhì)量10.2.1項目文檔結(jié)構(gòu)

10.2.2文檔標(biāo)準(zhǔn)10.2.3文檔書寫風(fēng)格

2024/1/201210.2.1項目文檔結(jié)構(gòu)（1）文檔的內(nèi)容決定了文檔的結(jié)構(gòu)，文檔結(jié)構(gòu)隨項目不同而不同，但一般都要符合以下的基本原則：所有文檔（不論大小、長短）都應(yīng)該有封面，用來標(biāo)識該項目文檔的作者、制作時間、文檔類型、配置管理、質(zhì)量確保信息和文檔的秘級等，還包括文檔的摘要、關(guān)鍵字及版權(quán)信息。如圖10.2。文檔應(yīng)分章節(jié)描述。如果文檔包括許多細(xì)節(jié)性參考信息，應(yīng)該有附錄。文檔應(yīng)該有難點(diǎn)注釋和詳細(xì)說明。文檔的結(jié)構(gòu)通常應(yīng)當(dāng)是嚴(yán)整的，并且有一定的標(biāo)準(zhǔn)。2024/1/201310.2.1項目文檔結(jié)構(gòu)（2）

2024/1/2014文檔封面的主要信息：標(biāo)題：項目：文檔ID：文檔類型：版本：日期：作者：是否被檢查：是/否是否被同意：N/A提交給CM：CM_ID：發(fā)布：密級：關(guān)鍵詞：圖10.2項目文檔封面的主要信息10.2.2文檔標(biāo)準(zhǔn)（1）過程標(biāo)準(zhǔn)：這種標(biāo)準(zhǔn)定義了高質(zhì)量文檔應(yīng)該遵守的過程，定義了書寫文檔的方法。產(chǎn)品標(biāo)準(zhǔn)：這種標(biāo)準(zhǔn)操縱文檔本身。適用于在軟件開發(fā)過程中所有產(chǎn)生的文檔。交互標(biāo)準(zhǔn)：通過電子郵件和文檔數(shù)據(jù)庫交換文檔變得越來越重要，交互標(biāo)準(zhǔn)使得所有的文檔都存在可比性。交互標(biāo)準(zhǔn)的使用允許文檔通過電子化的方式進(jìn)行傳遞，能夠相互理解和規(guī)范，并且在最初的格式上進(jìn)行再創(chuàng)造。2024/1/2015包括：文檔標(biāo)準(zhǔn)是保證文檔質(zhì)量的基礎(chǔ)，根據(jù)一定的標(biāo)準(zhǔn)編寫文檔，可以有一致的外觀、結(jié)構(gòu)和質(zhì)量等。10.2.2文檔標(biāo)準(zhǔn)（2）——文檔編制過程2024/1/2016圖10.3文檔編制過程階段2：修改階段1：編制編寫最初文檔評審文檔整理評審意見修改文檔校對文字最終文檔確認(rèn)最終文檔設(shè)計文檔復(fù)審文檔打印文檔打印備份文檔階段3：發(fā)布10.2.2文檔標(biāo)準(zhǔn)（3）文檔編制中涉及到的一些產(chǎn)品標(biāo)準(zhǔn)有：文檔識別標(biāo)準(zhǔn)：項目都要產(chǎn)生許多文檔，每一個文檔都要求有一個獨(dú)特的識別標(biāo)準(zhǔn)。對于正式的文檔，它的識別標(biāo)準(zhǔn)可以是由配置管理人員專門定義的；對于非正式的文檔，其識別標(biāo)準(zhǔn)可以由項目經(jīng)理來定義。文檔結(jié)構(gòu)標(biāo)準(zhǔn)：在軟件項目中每一種類型的文檔都有一種合適的結(jié)構(gòu)，結(jié)構(gòu)標(biāo)準(zhǔn)就用來定義這種結(jié)構(gòu)，可以采用傳統(tǒng)的頁碼、頁眉、頁腳和章節(jié)等。文檔解釋標(biāo)準(zhǔn)：文檔解釋標(biāo)準(zhǔn)定義了文檔的總體“建筑風(fēng)格”，包括文檔中字體的大小、顏色及風(fēng)格的定義等。文檔更新標(biāo)準(zhǔn)：系統(tǒng)的變更應(yīng)在文檔中反映，因此應(yīng)該采用一種連續(xù)的方法來表示系統(tǒng)變更，即在文檔中確定更新的標(biāo)準(zhǔn)。文檔標(biāo)準(zhǔn)要適用于所有項目文檔及用戶文檔的最初版本。2024/1/201710.2.3文檔書寫風(fēng)格運(yùn)用主動的而不是被動的語氣。

運(yùn)用正確的術(shù)語和語法結(jié)構(gòu)。

句子不宜過長，盡量用短句。段落簡短。用詞簡潔，不要長篇累犢，質(zhì)量比數(shù)量更重要。簡明定義用到的專業(yè)術(shù)語。應(yīng)用標(biāo)題和子標(biāo)題。盡可能地逐條列舉事實(shí)。不要單純地參考數(shù)字、圖、表來理解信息，應(yīng)當(dāng)有一定的說明和注釋。2024/1/2018編寫文檔時，也應(yīng)該注意以下問題：10.3項目文檔準(zhǔn)備（1）文檔制作：文字處理器、文本格式器、表格和公式編輯器、繪圖工具包等。文檔修改：拼寫檢查器和風(fēng)格檢查器。文檔產(chǎn)品發(fā)布：桌面發(fā)布包、技術(shù)工作包等。最常用的文檔工具是系統(tǒng)編輯器，它支持文檔的產(chǎn)生和修改過程。2024/1/2019文檔的準(zhǔn)備分3個階段：10.3項目文檔準(zhǔn)備（2）2024/1/2020文檔管理系統(tǒng)：文檔索引文檔管理系統(tǒng)配置管理系統(tǒng)文檔參考用戶請求圖10.4文檔管理文檔數(shù)據(jù)庫

文檔管理系統(tǒng)可以維護(hù)關(guān)聯(lián)文檔的索引，并且從文檔的文本中產(chǎn)生索引。可以采用標(biāo)準(zhǔn)數(shù)據(jù)庫、配置管理工具和系統(tǒng)文件來建造。它是一個松散集成的系統(tǒng)，并且在部分系統(tǒng)里要求一定的原則。10.4主要項目文檔10.4.1項目開發(fā)立項報告10.4.2可行性研究報告10.4.3項目開發(fā)計劃報告10.4.4項目分析報告10.4.5項目設(shè)計報告10.4.6程序設(shè)計報告10.4.7項目測試報告10.4.8項目使用與維護(hù)手冊10.4.9項目評價報告10.4.10項目開發(fā)總結(jié)報告

2024/1/202110.4.1項目開發(fā)立項報告(1)概述：概述現(xiàn)行系統(tǒng)的組織結(jié)構(gòu)、功能、業(yè)務(wù)流程以及存在的主要問題。(2)新系統(tǒng)的目標(biāo)：開發(fā)新系統(tǒng)的意義和新系統(tǒng)實(shí)現(xiàn)后的功能、技術(shù)指標(biāo)、安全和保密性、新系統(tǒng)運(yùn)行環(huán)境等。(3)經(jīng)費(fèi)預(yù)測和經(jīng)費(fèi)來源。(4)項目進(jìn)度和完成期限。(5)驗收標(biāo)準(zhǔn)和方法。(6)移交的文檔資料。(7)開始可行性研究的組織隊伍、機(jī)構(gòu)與預(yù)算。(8)其他需要說明的有關(guān)問題。2024/1/2022項目開發(fā)立項報告是在項目正式開發(fā)前，由開發(fā)單位提出或委托開發(fā)單位提出要開發(fā)的新系統(tǒng)的目標(biāo)、功能、費(fèi)用、時間、對組織機(jī)構(gòu)的影響等內(nèi)容的申請項目立項文檔。項目開發(fā)立項報告主要包括以下內(nèi)容

:10.4.2可行性研究報告可行性研究報告主要包括以下內(nèi)容:(1)系統(tǒng)概述。(2)新系統(tǒng)的目標(biāo)、要求和約束。(3)可行性研究的基本準(zhǔn)則。(4)現(xiàn)行系統(tǒng)描述及現(xiàn)行系統(tǒng)存在的主要問題。(5)新系統(tǒng)對現(xiàn)行系統(tǒng)的影響。(6)投資與效益分析。(7)其他可選方案及國內(nèi)外同類方案的比較。(8)有關(guān)建議。2024/1/2023可行性研究階段的文檔是可行性研究報告?？尚行匝芯繄蟾媸歉鶕?jù)對現(xiàn)行系統(tǒng)的調(diào)查、分析和研究，提出若干個系統(tǒng)的開發(fā)方案及其評價，供領(lǐng)導(dǎo)進(jìn)行決策。10.4.3項目開發(fā)計劃報告(1)概述：主要包括系統(tǒng)開發(fā)的主要目標(biāo)、基本方針、參加人員、工作階段和內(nèi)容等。(2)開發(fā)計劃：系統(tǒng)開發(fā)各個工作階段或者子項目的劃分、任務(wù)、分工、負(fù)責(zé)人、計劃時間(開始及結(jié)束時間)、人力資源需求、資金及設(shè)備消耗、實(shí)際執(zhí)行情況等。可以用工作進(jìn)度表、甘特圖、網(wǎng)絡(luò)圖及關(guān)鍵路徑法等工具輔助管理。(3)驗收標(biāo)準(zhǔn)：每項工作完成后驗收的標(biāo)準(zhǔn)，包括時間、資金、質(zhì)量等。(4)協(xié)調(diào)方法：項目開發(fā)中各個單位、階段之間的銜接、協(xié)調(diào)方法、負(fù)責(zé)人、權(quán)限等。2024/1/2024項目開發(fā)計劃報告主要包括以下內(nèi)容

:10.4.4項目分析報告(1)概述(2)系統(tǒng)需求(3)新系統(tǒng)的目標(biāo)與新系統(tǒng)的功能(4)新系統(tǒng)的邏輯模型(5)新系統(tǒng)的運(yùn)行環(huán)境(6)新系統(tǒng)的驗收標(biāo)準(zhǔn)與培訓(xùn)計劃2024/1/2025項目分析報告主要包括以下內(nèi)容

:10.4.5項目設(shè)計報告(1)系統(tǒng)概述(2)系統(tǒng)總體結(jié)構(gòu)(3)計算機(jī)系統(tǒng)配置方案(4)代碼設(shè)計(5)文件/數(shù)據(jù)庫設(shè)計(6)輸入輸出設(shè)計(7)計算機(jī)處理過程設(shè)計(8)接口及通信環(huán)境設(shè)計(9)安全保密設(shè)計(10)數(shù)據(jù)準(zhǔn)備(11)系統(tǒng)測試計劃(12)培訓(xùn)計劃2024/1/2026包括以下內(nèi)容

:10.4.6程序設(shè)計報告(1)概述(2)程序結(jié)構(gòu)圖(3)程序控制圖(4)算法(5)程序流程圖(6)源程序(7)程序注釋及說明2024/1/2027包括以下內(nèi)容

:10.4.7項目測試報告(1)概述：說明項目測試的目的。(2)測試環(huán)境：有關(guān)軟、硬件、通信、數(shù)據(jù)庫、人員等情況。(3)測試內(nèi)容：系統(tǒng)、子系統(tǒng)、模塊的名稱、性能技術(shù)指標(biāo)等。(4)測試方案：測試的方法、測試數(shù)據(jù)、測試步驟、測試中故障的解決方案等。(5)測試結(jié)果：測試的實(shí)際情況。(6)結(jié)論：項目功能評價、性能技術(shù)指標(biāo)評價、結(jié)論。2024/1/2028包括以下內(nèi)容

:10.4.8項目使用與維護(hù)手冊(1)概述：主要包括系統(tǒng)功能、系統(tǒng)運(yùn)行環(huán)境(軟硬件環(huán)境)、系統(tǒng)安裝等內(nèi)容。(2)使用說明：系統(tǒng)操作使用說明較為詳細(xì)地說明了操作的目的、過程、方式、輸入輸出的數(shù)據(jù)等。最好將系統(tǒng)操作的界面圖放入說明書中，便于使用者學(xué)習(xí)與操作。(3)問題解釋：解釋了系統(tǒng)使用中可能出現(xiàn)的問題及解決辦法，如非常規(guī)操作命令、系統(tǒng)恢復(fù)過程及意外情況、與開發(fā)單位的聯(lián)系方式等。2024/1/2029包括以下內(nèi)容

:10.4.9項目評價報告項目評價報告主要根據(jù)項目可行性分析報告、項目分析報告、項目設(shè)計報告所確定的新系統(tǒng)的目標(biāo)、功能、性能、