軟件文件或者原始碼文件是指與軟件系統及其軟件工程過程有關聯的文字實體。文件的類型包括軟件需求文件,設計文件,測試文件,用戶手冊等。其中的需求文件,設計文件和測試文件一般是在軟件開發過程中由開發者寫就的,而用戶手冊等非過程類文件是由專門的非技術類寫作人員寫就的。

早期的軟件文件主要指的是用戶手冊,根據Barker[1]的定義,文件是用來對軟件系統介面元素的設計、規劃和實現過程的記錄,以此來增強系統的可用性。而Forward[2] 則認為軟件文件是被軟件工程師之間用作溝通交流的一種方式,溝通的資訊主要是有關所開發的軟件系統。Parnas[3]則強調文件的權威性,他認為文件應該提供對軟件系統的精確描述。

綜上,我們可以將軟件文件定義為:

  1. 文件是一種對軟件系統的書面描述;
  2. 文件應當精確地描述軟件系統;
  3. 軟件文件是軟件工程師之間用作溝通交流的一種方式;
  4. 文件的類型有很多種,包括軟件需求文件,設計文件,測試文件,用戶手冊等;
  5. 文件的呈現方式有很多種,可以是傳統的書面文字形式或圖表形式,也可是動態的網頁形式

參考文獻

編輯
  1. ^ T. T. Barker, "Software documentation: from instruction to integration," IEEE Transactions on Professional Communication, vol. 33, no. 4, 1990.
  2. ^ A. Forward, "Software Documentation – Building and Maintaining Artefacts of Communication," in Ottawa-Carleton Institute for Computer Science. vol. Master in Computer Science: University of Ottawa, 2002.
  3. ^ D. L. Parnas, "Precise Documentation: The Key To Better Software," in The Future of Software Engineering: Springer-Verlag Berlin Heidelberg, 2011, pp. 125-148.