《軟件文檔寫作》教學(xué)現(xiàn)狀及對策

朱紅軍

中圖分類號：G642.0 文獻(xiàn)標(biāo)識碼：A 文章編號：1002-7661（2015）01-0009-02

一、課程現(xiàn)狀

隨著軟件復(fù)雜程序的不斷增加，人們對軟件產(chǎn)品開發(fā)過程的系統(tǒng)化、規(guī)范化和標(biāo)準(zhǔn)化的要求也越來越嚴(yán)格。為保證軟件開發(fā)、維護(hù)等環(huán)節(jié)的有效管理以及方便軟件技術(shù)人員之間進(jìn)行技術(shù)交流，軟件生命周期的每一個階段都需要編制不同類型的文檔。軟件文檔和計算機(jī)程序及數(shù)據(jù)共同構(gòu)成能完成特定功能的計算機(jī)軟件，對軟件項目，特別是大型軟件項目來說，沒有文檔的軟件不能稱其為軟件。

軟件文檔在早期沒有固定的內(nèi)容和形式，直到1988年我國才出臺了計算機(jī)軟件產(chǎn)品開發(fā)文件編制指南GB/T8567-1988，對文件的主要內(nèi)容和形式做出了規(guī)定。在2006年對GB/T8567-1988標(biāo)準(zhǔn)進(jìn)行了修改，制定了新的計算機(jī)軟件產(chǎn)品開發(fā)文件編制指南GB 8567-2006。軟件文檔寫作技能作為軟件文檔工程師的核心技能，在IT行業(yè)越來越得到重視。為此，許多大學(xué)如麻省大學(xué)、浙江大學(xué)、南京大學(xué)等早已將軟件文檔寫作作為軟件類專業(yè)的專業(yè)課程，重慶郵電大學(xué)也已將《軟件文檔寫作》納入軟件工程學(xué)院軟件工程專業(yè)的專業(yè)課程。由此可見，《軟件文檔寫作》作為一門新課程，在IT行業(yè)技術(shù)需求的推動下正在逐步得到規(guī)范和重視。

二、教學(xué)現(xiàn)狀

《軟件文檔寫作》應(yīng)該基于軟件工程的思想，根據(jù)軟件產(chǎn)品開發(fā)過程中各類軟件文檔編制的實際需要和軟件文檔編制的國家標(biāo)準(zhǔn)，系統(tǒng)地講授計算機(jī)軟件開發(fā)各個階段文檔寫作的步驟、內(nèi)容、方法、工具、特點、要求以及撰寫與溝通技巧?！盾浖臋n寫作》作為一門新課程，在教育教學(xué)過程中還存在諸多問題，主要表現(xiàn)在以下幾點。

1.教材質(zhì)量不高

目前可供參考的軟件技術(shù)文檔寫作相關(guān)的教材不多，主要有清華大學(xué)出版社出版的《軟件文檔》、電子工業(yè)出版社出版的《軟件文檔寫作教程》及高等教育出版社出版的《軟件文檔編寫》等。這些教材或內(nèi)容陳舊（仍然根據(jù)GB/T8567-1988舊標(biāo)準(zhǔn)編寫），或只注重文檔寫作格式或?qū)懽鞴ぞ叩慕榻B，缺乏符合最新標(biāo)準(zhǔn)的文檔撰寫內(nèi)容詮釋和實例。因而，這樣照搬這些內(nèi)容將導(dǎo)致理論與實際的脫節(jié)，授課內(nèi)容不具有可操作性。

2.教學(xué)內(nèi)容枯燥

目前現(xiàn)有的可供參考的軟件技術(shù)文檔寫作相關(guān)的教材都普遍存在重理論、輕實踐的問題。大多教材僅敘述了軟件技術(shù)文檔的格式和要求，而缺乏對文檔內(nèi)容的確定過程和寫作技能技巧的介紹，因而，教學(xué)內(nèi)容枯燥，缺乏實用性。

3.教學(xué)資源匱乏

《軟件文檔寫作》是一門相對較新的課程，目前配套的資料（如PPT、案例和范文）都非常少，特別是符合最新國家標(biāo)準(zhǔn)GB8567-2006的資料，這就增加了教師備課和學(xué)生學(xué)習(xí)的難度。

4.教學(xué)方法陳舊

由于教學(xué)資源匱乏，在教學(xué)過程中教師普遍采用基于認(rèn)識學(xué)習(xí)理論的講授法教學(xué)。該方法造成學(xué)生對知識的掌握停留在初級認(rèn)知水平上，難以對其產(chǎn)生廣泛、靈活的遷移，實現(xiàn)對知識的加工和創(chuàng)造性應(yīng)用。

5.教學(xué)效率低下

由于教學(xué)內(nèi)容枯燥和教學(xué)方法陳舊，學(xué)生理解困難，學(xué)習(xí)興趣不高，從而使學(xué)生的綜合素質(zhì)和能力得不到培養(yǎng)和提高，學(xué)生在工作中不能靈活應(yīng)用所學(xué)知識解決實際問題，難以勝任文檔工程師的工作。

三、教學(xué)對策

在教學(xué)方法上，顧蓬蓬和施慶平等老師分別在軟件文檔寫作課程中探索了案例教學(xué)法。國外對軟件文檔寫作采用的標(biāo)準(zhǔn)與我國稍不同，但主流的教學(xué)方法依然是案例教學(xué)法。該方法能使學(xué)生在課堂學(xué)習(xí)中具有明確的學(xué)習(xí)目的，從而提高了學(xué)生學(xué)習(xí)的主觀能動性和課堂參與意識。

在教育心理學(xué)領(lǐng)域中，建構(gòu)主義理論認(rèn)為學(xué)習(xí)過程不是學(xué)習(xí)者被動接受知識，而是積極主動建構(gòu)知識的過程。基于此理論，建構(gòu)主義者提出了情景教學(xué)法，它強(qiáng)調(diào)把所學(xué)的知識置于真實的任務(wù)情境中，在教師的主導(dǎo)下讓學(xué)生在主動完成任務(wù)的過程中學(xué)會知識，并以此過程為載體全面培養(yǎng)提高學(xué)生的素質(zhì)和能力。情境教學(xué)法目前已經(jīng)在教學(xué)中得到廣泛應(yīng)用研究。實踐表明：在模擬真實的任務(wù)情境中，學(xué)生通過角色扮演充分調(diào)動了的主觀能力性。積極運(yùn)用學(xué)習(xí)資源和意義建構(gòu)、自主探索和協(xié)作學(xué)習(xí)的過程有利于學(xué)生學(xué)習(xí)、創(chuàng)造和協(xié)作能力的培養(yǎng)。

在模擬真實的任務(wù)情境中，學(xué)生通過角色扮演融入情景，可以感受真實現(xiàn)場的氛圍，深刻體會軟件文檔寫作的諸要素，便于理解軟件產(chǎn)品開發(fā)文件編制指南中規(guī)定的各部分內(nèi)容的必要性，因而，情境教學(xué)法是《軟件文檔寫作》教學(xué)過程中最有效的教學(xué)方法。