軟體文件
軟體文件或者原始碼文件是指與軟體系統及其軟體工程過程有關聯的文字實體。文件的類型包括軟體需求文件,設計文件,測試文件,使用者手冊等。其中的需求文件,設計文件和測試文件一般是在軟體開發過程中由開發者寫就的,而使用者手冊等非過程類文件是由專門的非技術類寫作人員寫就的。
早期的軟體文件主要指的是使用者手冊,根據Barker[1]的定義,文件是用來對軟體系統介面元素的設計、規劃和實現過程的記錄,以此來增強系統的可用性。而Forward[2] 則認為軟體文件是被軟體工程師之間用作溝通交流的一種方式,溝通的資訊主要是有關所開發的軟體系統。Parnas[3]則強調文件的權威性,他認為文件應該提供對軟體系統的精確描述[4]。
綜上,我們可以將軟體文件定義為:
- 文件是一種對軟體系統的書面描述;
- 文件應當精確地描述軟體系統;
- 軟體文件是軟體工程師之間用作溝通交流的一種方式;
- 文件的類型有很多種,包括軟體需求文件,設計文件,測試文件,使用者手冊等;
- 文件的呈現方式有很多種,可以是傳統的書面文字形式或圖表形式,也可是動態的網頁形式
參考文獻
- ^ T. T. Barker, "Software documentation: from instruction to integration," IEEE Transactions on Professional Communication, vol. 33, no. 4, 1990.
- ^ 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.
- ^ D. L. Parnas, "Precise Documentation: The Key To Better Software," in The Future of Software Engineering: Springer-Verlag Berlin Heidelberg, 2011, pp. 125-148.
- ^ 软件文档理解.