軟件項(xiàng)目文檔管理與版本控制的初步報告

1、word文檔 可自由復(fù)制編輯軟件項(xiàng)目文檔管理與版本控制的初步報告 一、現(xiàn)階段的問題： 版本與文檔管理中常見或可能存在的現(xiàn)象： Item 1. 項(xiàng)目的邏輯結(jié)構(gòu)不嚴(yán)謹(jǐn) Item 2.多人修改同一個文件 Item 3.用戶權(quán)限混亂或無權(quán)限控制 Item 4.上傳文檔的命名隨意 Item 5.從服務(wù)器上獲取最近版本時的疏忽 二、文檔與版本管理衡量標(biāo)準(zhǔn)：效率與質(zhì)量（軟件的一致性、冗余程度等） 三、解決方向： 1、項(xiàng)目文檔、文件夾結(jié)構(gòu)化分類管理 2、文檔命名規(guī)范化 3、操作權(quán)限控制 4、注意服務(wù)器唯一有效版本，本地備份輔助 四、初步解決辦法 創(chuàng)建文檔儲存庫，基于工具的資料庫或是一個共享目錄里建立的簡單的“

2、文件夾/文件”結(jié)構(gòu)。 1、管理范圍：開發(fā)庫、項(xiàng)目文檔、產(chǎn)品庫、構(gòu)建庫 1） 開發(fā)庫包括：A、源代碼B、執(zhí)行程序 2）文檔管理： A、項(xiàng)目文檔包括可行性研究報告(愿景)，項(xiàng)目開發(fā)計劃(立項(xiàng))，需求(說明書)，評審，軟件設(shè)計說明書，開發(fā)進(jìn)度月報，測試，相關(guān)開發(fā)文檔，參考資料，文檔模板，用戶（操作）手冊，項(xiàng)目開發(fā)總結(jié)報告 B、相關(guān)設(shè)備 C、參考資料（開發(fā)人員與客戶會談的材料，參考文獻(xiàn)，項(xiàng)目結(jié)束歸檔時電子郵件 3）產(chǎn)品庫 2、建立規(guī)范的目錄體系 目錄體系結(jié)構(gòu)圖如下：SVN開發(fā)庫管理(m2m)項(xiàng)目一源碼(FSU)SVN開發(fā)庫管理(m2m)項(xiàng)目一源碼(FSU)項(xiàng)目二源碼項(xiàng)目二源碼項(xiàng)目文檔管理(docs)項(xiàng)

3、目三源碼項(xiàng)目文檔管理(docs)項(xiàng)目三源碼可行性研究報告(愿景)可行性研究報告(愿景)項(xiàng)目開發(fā)計劃(立項(xiàng))項(xiàng)目開發(fā)計劃(立項(xiàng))需求(說明書)項(xiàng)目一需求(說明書)項(xiàng)目一評審評審軟件設(shè)計說明書軟件設(shè)計說明書開發(fā)進(jìn)度月報開發(fā)進(jìn)度月報測試測試測試計劃測試計劃缺陷變更與追蹤缺陷變更與追蹤測試用例設(shè)計測試用例設(shè)計測試分析總結(jié)測試分析總結(jié)相關(guān)開發(fā)文檔相關(guān)開發(fā)文檔參考資料參考資料參考文獻(xiàn)、技術(shù)資料客戶資料參考文獻(xiàn)、技術(shù)資料客戶資料其他文檔模板文檔模板用戶（操作）手冊項(xiàng)目二用戶（操作）手冊項(xiàng)目二項(xiàng)目開發(fā)總結(jié)報告項(xiàng)目開發(fā)總結(jié)報告 3、版本與文檔命名規(guī)則 1）版本V1.0至版本V2.0之間可少設(shè)過渡版本，變更量積累

4、之一定量或階段之后再進(jìn)行版本變更。對于計劃性文檔、技術(shù)文檔和用戶文檔，其版本按修改的先后順序確定，新生成的文檔第一次發(fā)行是第一版，修改后第二次發(fā)行是第二版，以此類推。 2）建立規(guī)范的文檔與版本命名規(guī)則，文檔控制級別為中、低的文檔是不需要進(jìn)行版本控制的，這些文檔大都是臨時性的、一次性的、中間性的文檔，比如：需求調(diào)研報告，會議紀(jì)要，項(xiàng)目報告等。文檔 控制級別為高的文檔要進(jìn)行版本控制。如：用戶需求說明書，概要設(shè)計說明書，用戶手冊等，無論修改有多少次，都要求留版本記錄，尤其是項(xiàng)目產(chǎn)品。 控制級別高的文檔命名： 項(xiàng)目編號_文檔名與版本號_日期_作者， 如SPMS_需求說明書V1.0_YYMMDD_李明

5、控制級別為中、低的文檔命名： 項(xiàng)目編號_文檔名_日期_作者，如SPMS_第六周問題報告_YYMMDD_李明 3）最終完成的軟件版本用二位符號表示：“ s.xy”，含義如下： “ y ” 為第二次版本號，表示糾正錯誤時的版本升級，用一位數(shù)字表示：“ 1-9 ” 對上一次產(chǎn)品或項(xiàng)目的缺陷做修正，第二次版本號增加； “ x ” 為第一次版本號，表示增加功能時的版本升級，用一位數(shù)字表示：“ 1-9 ” ，與上一產(chǎn)品或項(xiàng)目相比，功能進(jìn)行了小量的增加或修正時，第一次版本號增加，第二次版本號為零，第二版本號為零時可以省略不寫； “ s ” 為主版本號，用一位數(shù)字表示：“ 1-9 ” ，對產(chǎn)品作重大調(diào)整，或與

6、已發(fā)行的上一產(chǎn)品相比，在功能與性能上有較大改善時主版本號增加，次版本號為零，產(chǎn)品或項(xiàng)目概念全新，第一次完成，版本號為1.0。 4、人員職責(zé)與維護(hù)、更新 文檔管理的人員可以由一個或多個團(tuán)隊(duì)成員兼職擔(dān)任，有經(jīng)驗(yàn)最好，職責(zé)包括： 建立、管理和執(zhí)行文檔標(biāo)準(zhǔn)并監(jiān)控它們的狀態(tài)； 確認(rèn)并解決文檔庫中存在的問題； 確定對哪些文件進(jìn)行存檔或?qū)δ男┡f文件（如每周的狀態(tài)情況報告在三個月以后可能就會作廢）進(jìn)行定期、階段性的清理； 創(chuàng)建資料庫的訪問規(guī)則、權(quán)限； 定期對資料庫進(jìn)行檢查，并對文檔管理流程進(jìn)行評估，應(yīng)當(dāng)確保文檔管理流程工作正常而且符合公司、項(xiàng)目組和利益相關(guān)方的需求； 5、關(guān)于項(xiàng)目開發(fā)與測試等其他人員，同樣需要

7、注意文檔提交、更新、維護(hù)等的規(guī)范，建議如下： 1）開發(fā)和測試人員在提交相關(guān)文檔后，自己應(yīng)有備份。 2）軟件開發(fā)和測試人員可根據(jù)工作需要在自己手中保存一些個人文檔。這些一般應(yīng)是主文本的副本，并注意和提交的主文本保持一致，在作必要的修改時，也應(yīng)及時通知文檔管理人員。 3）在新文檔取代舊文檔時，管理人員應(yīng)及時清理舊文檔。在文檔內(nèi)容有改動時，管理人員應(yīng)隨時修訂主文本，使其及時反映更新了的內(nèi)容。 4）項(xiàng)目開發(fā)結(jié)束時，文檔管理人員應(yīng)及時收集開發(fā)和測試人員的個人文檔。發(fā)現(xiàn)個人文檔與主文本有差別時，應(yīng)立即著手解決。這常常是未及時修訂主文本造成的。 5）在軟件開發(fā)過程中，可能發(fā)現(xiàn)需要修改已完成的文檔，特別是規(guī)模

8、較大的項(xiàng)目，主文本的修改必須特別謹(jǐn)慎。修改以前要充分估計可能帶來的影響，并且要按照：提議、評議、審核、批準(zhǔn)和實(shí)施等的步驟加以嚴(yán)格控制。 其他建議： 1）版本控制管理可包括工具軟件的使用和人為規(guī)范的遵循有控制意識、對工具的熟練使用，認(rèn)為的良好習(xí)慣，和規(guī)范的制度的保證。 2）版本控制管理員設(shè)置一人或數(shù)人兼顧此角色，沒必要是全職，保證安全性問題，控制認(rèn)為任意操作。 3）向版本控制過渡時一個循序漸進(jìn)的、持久的過程需要逐步轉(zhuǎn)變，制訂一系列的循序漸進(jìn)的措施，使版本控制的意識逐步得到認(rèn)可，使人員逐漸養(yǎng)成良好習(xí)慣。 4）分為開發(fā)庫、文檔庫、產(chǎn)品庫、構(gòu)建庫，這四個庫分別是獨(dú)立的單庫，版本不相互影響。 開發(fā)庫下項(xiàng)目一的相對路徑為：/dev/pro1，在pro1下為該項(xiàng)目的具體源碼結(jié)構(gòu)樹； 文檔庫下項(xiàng)目一的相對路徑為： /doc/pro1，在pro1下為該項(xiàng)目的文檔樹結(jié)構(gòu)（包括且不限于項(xiàng)目立項(xiàng)、項(xiàng)目結(jié)項(xiàng)、項(xiàng)目計劃、項(xiàng)目監(jiān)控、風(fēng)險管理、配置管理.），相應(yīng)的文檔 放入到相應(yīng)的文件夾中； 構(gòu)建庫下項(xiàng)目一的相對路徑為:/db/pro1，在pro1下為該項(xiàng)目不同時期的