什么是測試文檔？
當我從前任測試同事手中接過“薄薄兩頁紙”的測試文檔時，我難以置信的看著他問“沒有了嗎？只有這些？”。同事尷尬的點點頭，又再說了一句讓我吐血的話“測試計劃和記錄文檔都在我心里記得清清楚楚呢”。這完全是對測試文檔的誤解，這也是許多軟件測試技術人員的通病。
項目測試文檔是用來記錄、描述、展示測試過程中一系列測試信息的處理過程，通過書面或圖示的形式對項目測試活動過程或結果進行描述、定義及報告。例如，分階段測試計劃文檔，測試流程文檔，測試數(shù)據(jù)文檔，測試參數(shù)設置文檔和測試指南文檔等。這些文檔將會伴隨著軟件測試的各個階段逐漸充實、完善，同時也記載了整個測試的過程和成果。
作為測試技術人員，在測試過程中應將各種標準測試文檔提交給項目組，以確保軟件測試項目的質(zhì)量。也就是說，測試技術人員的工作績效與文檔的高質(zhì)量提交息息相關，它描述項目測試過程的每一個細節(jié)。因此，從某種程度上講，測試管理的核心其實就是測試文檔管理。
（1）測試文檔有助于項目測試水平的提高
從內(nèi)容上說，項目測試文檔大致可以分為測試成果文檔和測試過程文檔兩大類。測試成果文檔作為項目可交付物的一個組成部分，其重要性自然不言而喻。測試過程文檔主要記錄了項目測試過程中的各種信息，為測試人員提供決策依據(jù)，以保證項目的順利實現(xiàn)。另一方面，測試過程文檔也是測試過程為寶貴的資產(chǎn)，通過對過程文檔進行歸納和分析，可以對測試項目的成功經(jīng)驗和失敗教訓了然于胸，從而使后續(xù)的測試運作更加有的放矢。
（2）測試文檔驅動著測試過程
測試項目的階段性成果是以測試文檔形式體現(xiàn)的，因此，“測試項目的運作在一定程度上是由測試文檔驅動的”這句話是有道理的。從測試文檔的角度來看，項目測試過程就是一個文檔制作與執(zhí)行的過程。在項目測試的過程中，每項工作的事前計劃、事中測試記錄、事后分析結果都要形成相應的測試文檔，文檔包括與項目相關的資源及其使用情況。
因此，測試文檔是軟件項目的一部分，沒有正式的測試文檔的活動，就不是規(guī)范的測試。測試文檔的編制和管理在項目測試中占有突出的地位和相當大的工作量，高質(zhì)量地編制、變更、修正、管理和維護文檔，對于提高項目測試的質(zhì)量和客戶滿意度有著重要的現(xiàn)實意義。
“文檔”不誤“測試”功
與本項目前任負責同事一樣，很多人對測試文檔的作用存在非常多的誤解，認為測試的事情本來就多，有數(shù)不過來得Bug要急著測試和處理，根本沒有時間寫文檔。有了這樣的想法，就開始忽略文檔，認為寫測試文檔太累，能用嘴說的就不用手寫，能簡單寫的就絕不詳細寫。當需要匯報的時候，好吧，我講給你聽，動嘴肯定簡單多了。
實際上，測試文檔是一種工具，古語云“磨刀不誤砍柴功”，我們則說“文檔”不誤“測試”功。一個項目測試是否高質(zhì)量完成，一般可以從兩個方面進行評價:① 能否提供高質(zhì)量的測試活動和結果。②能否提供有效的測試文檔。而對于后者，高質(zhì)量的測試文檔正常體現(xiàn)前者是否高質(zhì)量完成的證明。
（1）提高項目測試過程的能見度。標準規(guī)范、齊全的文檔會詳細記錄測試過程中發(fā)生的事件，便于測試人員掌握測試進度、測試質(zhì)量以及各種資源的調(diào)配。同時，文檔有助于測試人員與開發(fā)人員明確了解各自的職責，信息互通，共同把握測試和開發(fā)的節(jié)奏。
（2）文檔化能規(guī)范測試問題的反饋，提高測試效率。測試人員用一定時間編制、整理測試文檔，可以使測試人員對各個階段的工作都進行周密思考和理順、找出存在的問題，從而減少差錯，提高項目測試質(zhì)量。例如，測試過程中肯定會遇到各種各樣的問題，諸如軟件問題或測試設置等需要向開發(fā)組反饋來尋求解決，通過對文檔的檢查，在項目測試早期發(fā)現(xiàn)文檔錯誤和不一致，加以及時糾正，可以減少深入項目而導致的大問題的出現(xiàn)和為糾正失誤而付出的更大的成本。
這類問題又分兩種情況：①是重要的反饋遲遲得不到解決和回復，當文檔化做得好時，在出現(xiàn)問題的時候，打開文檔可以一目了然，責任沒法推卸?？突f過，通常人是不會或者沒有人愿意承認自己是錯的，即使承認，也并不是100%地這么認為。我們在測試過程中就要避免這樣的問題發(fā)生。②是有些問題在不同部門和不同的階段頻繁出現(xiàn)。簡單而又瑣碎的重復問題會讓測試人員疲于奔命，效率低下。這時，一個文檔化的FAQ問題集對項目測試就顯得意義重大。
（3）便于團隊成員之間的交流與合作。描述清楚、完備的測試文檔便于項目組領導了解測試過程中的各項指標，為開發(fā)團隊與測試團隊之間架起的一座橋梁。文檔是一種無聲的語言，它記錄了項目測試過程中有關測試配置、測試運行、測試結果等方面的信息，有利于項目管理人員、測試人員之間的交流和合作。
另一方面，測試文檔的重要性還表現(xiàn)在對于項目“傳承”的重要性，有了好的文檔，那么當項目有新成員進入，測試文檔就可以承擔起指導新成員快速工作的作用，而不是單單詢問原來的成員，節(jié)省了大家的時間。還有，當測試完成后，測試文檔就將成為項目測試的文字載體，在后續(xù)人員培訓方面提供詳盡的素材。
（4）測試文檔是測試人員經(jīng)驗提升的好途徑
善于學習，對于任何職業(yè)而言都是前進所必需的動力。對于軟件測試來說，這種要求就更加高了，項目文檔對于項目測試人員的素質(zhì)提升大有裨益的。目前不少企業(yè)在進行項目測試時都會出現(xiàn)一個通?。河捎谌藛T素質(zhì)有限，許多的決定只憑口頭敘述，缺少足夠的文字記錄，以至出現(xiàn)問題時往往顯得無所適從。從本質(zhì)上講，測試文檔強調(diào)的是一種規(guī)范化管理，要求項目人員利用書面語言進行溝通表達，以指引項目運作。
測試人員不應該只為寫測試文檔而寫文檔，良好的文檔是思想交流、溝通的基礎，也是整理和理清思路的基礎。不懂得從經(jīng)驗中學習和成長，永遠不會有質(zhì)的提高。只有當每次完成一個測試任務，都有目的的總結，找到自己的不足，一個合格的測試人員才可能成長起來。
（5）有利于項目測試的監(jiān)控作用。測試本身是一項風險很高的工程，需要進行嚴謹?shù)捻椖勘O(jiān)控。階段性的檢查、評審和文檔化成果是重要的方法之一，詳盡而規(guī)范的測試文檔成果不僅有利于監(jiān)控項目進度，也利于項目驗收。
測試文檔常見問題
測試文檔是否專業(yè)已成為測試管理和測試人員的重要評價指標之一。但是，普遍還會存在這些缺點：
（1）文檔編寫不夠規(guī)范。主要是測試文檔內(nèi)容描寫不夠完善，在編寫各種測試文檔過程中，雖然大家都按事先規(guī)定的模式進行了編寫，但編寫的內(nèi)容經(jīng)常不夠完善。要么文檔極其簡單，相當于沒有文檔。要么文檔流于形式，沒有什么實際的價值，甚至于有的測試文檔與測試過程完全不符。
（2）測試文檔沒有統(tǒng)一入庫管理。隨著軟件開發(fā)的不斷深入、升級，新Bug不斷產(chǎn)生，各種測試文檔越來越多，沒有建立一個測試文檔資料庫。在測試過程中沒有對每一個階段的文檔進行整理，分層次管理，各類文檔資料缺少一致性。不同時期的各種測試文檔零散存在，造成查詢測試文檔時非常困難。在眾多的測試文檔中，其中一些文檔必定是關鍵文檔，起到非常重要的作用，對于這類測試文檔沒有設定優(yōu)先級別特別說明。
（3）只重視測試文檔的形式，實用性不強。在實際的測試過程中，編制人員沒有時間去關心它們的用途，也不知道哪些部門使用，更多的是在規(guī)定的時間內(nèi)完成任務，以免影響考核成績。這樣一來一些不實用的、重復的文檔不但阻礙著測試的執(zhí)行效率，而且影響項目的整體進度。因此，文檔的制定要實用，以減少繁文縟節(jié)的文字工作。
如何管理測試文檔
如前文所述，測試文檔對于項目管理的作用是不容置疑的，但測試文檔的管理卻又通常是項目管理中容易忽略的。我認為在測試文檔管理中應該要注意以下幾個方面：
（1）建立測試文檔管理制度。重點應體現(xiàn)為兩點：①要對測試文檔的名稱、標識、類型、責任人、內(nèi)容等基本內(nèi)容做出事先安排，給出測試文檔總覽表。②是制定對各種測試文檔的管理程序，如批準、發(fā)布、修訂、標識、貯存、傳遞、查閱等，為測試文檔配置管理鋪設一個良好的基礎平臺。
（2）文檔版本管理，而且非常重要。版本混亂是測試文檔的一個致命傷，測試文檔的有效管理必須實行版本控制。
（3）創(chuàng)建測試文檔庫的訪問規(guī)則，這是文檔管理的重要環(huán)節(jié)。訪問規(guī)則確定誰可以訪問、閱讀、升級及在文檔庫中添加文檔。同時，文檔庫還應定期進行檢查，以便對哪些文件進行存檔或對哪些舊文件進行清理，以確保文檔管理符合項目測試組的需求。
（4）使用工具管理文檔。對于一個大型的項目測試，整個測試周期中都會有大量的文檔。測試文檔內(nèi)容也是在不斷變化的，有的是連續(xù)的，承前啟后的，有的是新增加的，也有的是廢除的。這可能需要一個統(tǒng)一的文檔管理工具，分門別類統(tǒng)一存放管理各種測試文檔。
總之，測試文檔在軟件測試過程中起到關鍵的作用，從某種意義上來說，測試文檔是項目測試規(guī)范的體現(xiàn)和指南，按照規(guī)范要求編制一整套測試文檔的過程，就是完成一個測試項目的過程。
當我從前任測試同事手中接過“薄薄兩頁紙”的測試文檔時，我難以置信的看著他問“沒有了嗎？只有這些？”。同事尷尬的點點頭，又再說了一句讓我吐血的話“測試計劃和記錄文檔都在我心里記得清清楚楚呢”。這完全是對測試文檔的誤解，這也是許多軟件測試技術人員的通病。
項目測試文檔是用來記錄、描述、展示測試過程中一系列測試信息的處理過程，通過書面或圖示的形式對項目測試活動過程或結果進行描述、定義及報告。例如，分階段測試計劃文檔，測試流程文檔，測試數(shù)據(jù)文檔，測試參數(shù)設置文檔和測試指南文檔等。這些文檔將會伴隨著軟件測試的各個階段逐漸充實、完善，同時也記載了整個測試的過程和成果。
作為測試技術人員，在測試過程中應將各種標準測試文檔提交給項目組，以確保軟件測試項目的質(zhì)量。也就是說，測試技術人員的工作績效與文檔的高質(zhì)量提交息息相關，它描述項目測試過程的每一個細節(jié)。因此，從某種程度上講，測試管理的核心其實就是測試文檔管理。
（1）測試文檔有助于項目測試水平的提高
從內(nèi)容上說，項目測試文檔大致可以分為測試成果文檔和測試過程文檔兩大類。測試成果文檔作為項目可交付物的一個組成部分，其重要性自然不言而喻。測試過程文檔主要記錄了項目測試過程中的各種信息，為測試人員提供決策依據(jù)，以保證項目的順利實現(xiàn)。另一方面，測試過程文檔也是測試過程為寶貴的資產(chǎn)，通過對過程文檔進行歸納和分析，可以對測試項目的成功經(jīng)驗和失敗教訓了然于胸，從而使后續(xù)的測試運作更加有的放矢。
（2）測試文檔驅動著測試過程
測試項目的階段性成果是以測試文檔形式體現(xiàn)的，因此，“測試項目的運作在一定程度上是由測試文檔驅動的”這句話是有道理的。從測試文檔的角度來看，項目測試過程就是一個文檔制作與執(zhí)行的過程。在項目測試的過程中，每項工作的事前計劃、事中測試記錄、事后分析結果都要形成相應的測試文檔，文檔包括與項目相關的資源及其使用情況。
因此，測試文檔是軟件項目的一部分，沒有正式的測試文檔的活動，就不是規(guī)范的測試。測試文檔的編制和管理在項目測試中占有突出的地位和相當大的工作量，高質(zhì)量地編制、變更、修正、管理和維護文檔，對于提高項目測試的質(zhì)量和客戶滿意度有著重要的現(xiàn)實意義。
“文檔”不誤“測試”功
與本項目前任負責同事一樣，很多人對測試文檔的作用存在非常多的誤解，認為測試的事情本來就多，有數(shù)不過來得Bug要急著測試和處理，根本沒有時間寫文檔。有了這樣的想法，就開始忽略文檔，認為寫測試文檔太累，能用嘴說的就不用手寫，能簡單寫的就絕不詳細寫。當需要匯報的時候，好吧，我講給你聽，動嘴肯定簡單多了。
實際上，測試文檔是一種工具，古語云“磨刀不誤砍柴功”，我們則說“文檔”不誤“測試”功。一個項目測試是否高質(zhì)量完成，一般可以從兩個方面進行評價:① 能否提供高質(zhì)量的測試活動和結果。②能否提供有效的測試文檔。而對于后者，高質(zhì)量的測試文檔正常體現(xiàn)前者是否高質(zhì)量完成的證明。
（1）提高項目測試過程的能見度。標準規(guī)范、齊全的文檔會詳細記錄測試過程中發(fā)生的事件，便于測試人員掌握測試進度、測試質(zhì)量以及各種資源的調(diào)配。同時，文檔有助于測試人員與開發(fā)人員明確了解各自的職責，信息互通，共同把握測試和開發(fā)的節(jié)奏。
（2）文檔化能規(guī)范測試問題的反饋，提高測試效率。測試人員用一定時間編制、整理測試文檔，可以使測試人員對各個階段的工作都進行周密思考和理順、找出存在的問題，從而減少差錯，提高項目測試質(zhì)量。例如，測試過程中肯定會遇到各種各樣的問題，諸如軟件問題或測試設置等需要向開發(fā)組反饋來尋求解決，通過對文檔的檢查，在項目測試早期發(fā)現(xiàn)文檔錯誤和不一致，加以及時糾正，可以減少深入項目而導致的大問題的出現(xiàn)和為糾正失誤而付出的更大的成本。
這類問題又分兩種情況：①是重要的反饋遲遲得不到解決和回復，當文檔化做得好時，在出現(xiàn)問題的時候，打開文檔可以一目了然，責任沒法推卸?？突f過，通常人是不會或者沒有人愿意承認自己是錯的，即使承認，也并不是100%地這么認為。我們在測試過程中就要避免這樣的問題發(fā)生。②是有些問題在不同部門和不同的階段頻繁出現(xiàn)。簡單而又瑣碎的重復問題會讓測試人員疲于奔命，效率低下。這時，一個文檔化的FAQ問題集對項目測試就顯得意義重大。
（3）便于團隊成員之間的交流與合作。描述清楚、完備的測試文檔便于項目組領導了解測試過程中的各項指標，為開發(fā)團隊與測試團隊之間架起的一座橋梁。文檔是一種無聲的語言，它記錄了項目測試過程中有關測試配置、測試運行、測試結果等方面的信息，有利于項目管理人員、測試人員之間的交流和合作。
另一方面，測試文檔的重要性還表現(xiàn)在對于項目“傳承”的重要性，有了好的文檔，那么當項目有新成員進入，測試文檔就可以承擔起指導新成員快速工作的作用，而不是單單詢問原來的成員，節(jié)省了大家的時間。還有，當測試完成后，測試文檔就將成為項目測試的文字載體，在后續(xù)人員培訓方面提供詳盡的素材。
（4）測試文檔是測試人員經(jīng)驗提升的好途徑
善于學習，對于任何職業(yè)而言都是前進所必需的動力。對于軟件測試來說，這種要求就更加高了，項目文檔對于項目測試人員的素質(zhì)提升大有裨益的。目前不少企業(yè)在進行項目測試時都會出現(xiàn)一個通?。河捎谌藛T素質(zhì)有限，許多的決定只憑口頭敘述，缺少足夠的文字記錄，以至出現(xiàn)問題時往往顯得無所適從。從本質(zhì)上講，測試文檔強調(diào)的是一種規(guī)范化管理，要求項目人員利用書面語言進行溝通表達，以指引項目運作。
測試人員不應該只為寫測試文檔而寫文檔，良好的文檔是思想交流、溝通的基礎，也是整理和理清思路的基礎。不懂得從經(jīng)驗中學習和成長，永遠不會有質(zhì)的提高。只有當每次完成一個測試任務，都有目的的總結，找到自己的不足，一個合格的測試人員才可能成長起來。
（5）有利于項目測試的監(jiān)控作用。測試本身是一項風險很高的工程，需要進行嚴謹?shù)捻椖勘O(jiān)控。階段性的檢查、評審和文檔化成果是重要的方法之一，詳盡而規(guī)范的測試文檔成果不僅有利于監(jiān)控項目進度，也利于項目驗收。
測試文檔常見問題
測試文檔是否專業(yè)已成為測試管理和測試人員的重要評價指標之一。但是，普遍還會存在這些缺點：
（1）文檔編寫不夠規(guī)范。主要是測試文檔內(nèi)容描寫不夠完善，在編寫各種測試文檔過程中，雖然大家都按事先規(guī)定的模式進行了編寫，但編寫的內(nèi)容經(jīng)常不夠完善。要么文檔極其簡單，相當于沒有文檔。要么文檔流于形式，沒有什么實際的價值，甚至于有的測試文檔與測試過程完全不符。
（2）測試文檔沒有統(tǒng)一入庫管理。隨著軟件開發(fā)的不斷深入、升級，新Bug不斷產(chǎn)生，各種測試文檔越來越多，沒有建立一個測試文檔資料庫。在測試過程中沒有對每一個階段的文檔進行整理，分層次管理，各類文檔資料缺少一致性。不同時期的各種測試文檔零散存在，造成查詢測試文檔時非常困難。在眾多的測試文檔中，其中一些文檔必定是關鍵文檔，起到非常重要的作用，對于這類測試文檔沒有設定優(yōu)先級別特別說明。
（3）只重視測試文檔的形式，實用性不強。在實際的測試過程中，編制人員沒有時間去關心它們的用途，也不知道哪些部門使用，更多的是在規(guī)定的時間內(nèi)完成任務，以免影響考核成績。這樣一來一些不實用的、重復的文檔不但阻礙著測試的執(zhí)行效率，而且影響項目的整體進度。因此，文檔的制定要實用，以減少繁文縟節(jié)的文字工作。
如何管理測試文檔
如前文所述，測試文檔對于項目管理的作用是不容置疑的，但測試文檔的管理卻又通常是項目管理中容易忽略的。我認為在測試文檔管理中應該要注意以下幾個方面：
（1）建立測試文檔管理制度。重點應體現(xiàn)為兩點：①要對測試文檔的名稱、標識、類型、責任人、內(nèi)容等基本內(nèi)容做出事先安排，給出測試文檔總覽表。②是制定對各種測試文檔的管理程序，如批準、發(fā)布、修訂、標識、貯存、傳遞、查閱等，為測試文檔配置管理鋪設一個良好的基礎平臺。
（2）文檔版本管理，而且非常重要。版本混亂是測試文檔的一個致命傷，測試文檔的有效管理必須實行版本控制。
（3）創(chuàng)建測試文檔庫的訪問規(guī)則，這是文檔管理的重要環(huán)節(jié)。訪問規(guī)則確定誰可以訪問、閱讀、升級及在文檔庫中添加文檔。同時，文檔庫還應定期進行檢查，以便對哪些文件進行存檔或對哪些舊文件進行清理，以確保文檔管理符合項目測試組的需求。
（4）使用工具管理文檔。對于一個大型的項目測試，整個測試周期中都會有大量的文檔。測試文檔內(nèi)容也是在不斷變化的，有的是連續(xù)的，承前啟后的，有的是新增加的，也有的是廢除的。這可能需要一個統(tǒng)一的文檔管理工具，分門別類統(tǒng)一存放管理各種測試文檔。
總之，測試文檔在軟件測試過程中起到關鍵的作用，從某種意義上來說，測試文檔是項目測試規(guī)范的體現(xiàn)和指南，按照規(guī)范要求編制一整套測試文檔的過程，就是完成一個測試項目的過程。