軟件工程專業(yè)學(xué)生的文檔能力培養(yǎng)

楊珂　雷開彬　楊玉涵

摘要：文檔是軟件產(chǎn)品的重要組成部分，但在目前的軟件工程教學(xué)中，對(duì)學(xué)生文檔能力的培養(yǎng)仍然欠缺有效的方法。文章首先分析學(xué)生文檔能力不足的原因，在此基礎(chǔ)上提出對(duì)學(xué)生文檔能力培養(yǎng)的基本要求，探索在項(xiàng)目教學(xué)法中著重培養(yǎng)學(xué)生文檔能力的教學(xué)新方法和新思路，總結(jié)能夠提高學(xué)生文檔能力的有效方法和技巧。

關(guān)鍵詞：文檔能力；軟件工程；課程設(shè)計(jì)；軟件創(chuàng)新；項(xiàng)目驅(qū)動(dòng)

0、引言

目前，軟件工程課程教學(xué)中普遍存在著重代碼、輕文檔的現(xiàn)象，而在實(shí)際的軟件工程開發(fā)實(shí)踐中，一般認(rèn)為代碼的工作量只占整個(gè)工程工作量的30%左右，而相關(guān)的完整、有效的各種文檔，包括設(shè)計(jì)文檔、算法文檔、說明文檔、維護(hù)文檔等才是整個(gè)軟件工程的核心所在。為了加深學(xué)生對(duì)軟件文檔的正確認(rèn)識(shí)，培養(yǎng)學(xué)生軟件文檔的編寫和審核能力，增強(qiáng)學(xué)生的軟件工程能力，我們必須轉(zhuǎn)變教學(xué)觀念，在教學(xué)過程的各個(gè)環(huán)節(jié)中突出文檔的重要地位，強(qiáng)調(diào)設(shè)計(jì)對(duì)于軟件的正面作用，將各種統(tǒng)一、標(biāo)準(zhǔn)、高效和實(shí)用的文檔設(shè)計(jì)和撰寫方案融入課程教學(xué)中，并且與軟件工程理論和代碼編寫結(jié)合，形成完整的理論、算法、代碼和文檔并重的教學(xué)新方法。

1、文檔能力的重要性及現(xiàn)狀

軟件產(chǎn)品被定義為包括程序、數(shù)據(jù)及其相關(guān)文檔的完整集合。由此可見，文檔是軟件產(chǎn)品中不可或缺的重要組成部分。作為軟件工程過程中的重要里程碑和有效的交流工具，文檔不僅能夠幫助開發(fā)人員掌握自己的工作進(jìn)度，方便團(tuán)隊(duì)中的所有成員理解和改進(jìn)代碼，還能幫助項(xiàng)目管理人員對(duì)軟件開發(fā)進(jìn)程進(jìn)行有效控制和管理，進(jìn)而提高軟件開發(fā)的效率和質(zhì)量，改進(jìn)軟件開發(fā)過程。

在目前實(shí)際的課程教學(xué)中，雖然引入了案例教學(xué)、校企合作等方法，也結(jié)合了國內(nèi)外一些有效的軟件工程教學(xué)方法，但實(shí)際教學(xué)效果卻遠(yuǎn)遠(yuǎn)跟不上現(xiàn)實(shí)中軟件行業(yè)的實(shí)際需要。通過調(diào)查發(fā)現(xiàn)，大部分學(xué)生并不能理解文檔在軟件工程中的重要地位，不知如何編制規(guī)范有效的文檔，如何使用和管理文檔。經(jīng)過了解、調(diào)查和分析，造成這種現(xiàn)狀的原因主要有3個(gè)方面。

（1）在前兩年的專業(yè)基礎(chǔ)課學(xué)習(xí)中，所有程序都是經(jīng)過簡單設(shè)計(jì)后直接映射為程序，學(xué)生沒有接觸過軟件文檔，缺乏對(duì)思維邏輯的條理性強(qiáng)化。

（2）高年級(jí)課程中的項(xiàng)目復(fù)雜性不高，學(xué)生無法意識(shí)到缺乏有效的文檔給項(xiàng)目帶來的深遠(yuǎn)影響。教師雖然反復(fù)強(qiáng)調(diào)文檔的重要性，但由于學(xué)生的經(jīng)歷和經(jīng)驗(yàn)有限，很難引起共鳴。

（3）軟件文檔本身的多樣性、復(fù)雜性和高質(zhì)量要求，使文檔編寫成為一項(xiàng)艱苦和枯燥的勞動(dòng)過程，進(jìn)一步加重了學(xué)生對(duì)軟件文檔無從下手和望而卻步的感受。

2、文檔能力培養(yǎng)的內(nèi)容和要求

我國于2006年發(fā)布了國家標(biāo)準(zhǔn)《計(jì)算機(jī)軟件文檔編制規(guī)范（GB/T 8567-2006）》（以下簡稱《規(guī)范》），作為軟件開發(fā)人員工作的準(zhǔn)則和規(guī)程。鑒于計(jì)算機(jī)系統(tǒng)的多樣性，該標(biāo)準(zhǔn)一般不涉及整個(gè)系統(tǒng)開發(fā)中的文檔編制問題，而僅僅是軟件開發(fā)過程中的文檔編制指南。因此，考慮到教學(xué)適用的軟件項(xiàng)目復(fù)雜度以及學(xué)生的技術(shù)能力等限制因素，文中涉及的文檔能力僅以《規(guī)范》作為指導(dǎo)。軟件工程專業(yè)學(xué)生文檔能力包括文檔編寫能力、文檔審查和評(píng)審能力。

2.1 文檔編寫能力

軟件文檔的編寫是保證軟件質(zhì)量的重要措施，也是軟件維護(hù)的主要依據(jù)。因此，一定要注重培養(yǎng)學(xué)生的文檔編寫能力，使學(xué)生能夠嚴(yán)格按照軟件工程規(guī)范的要求，遵循常見軟件文檔的規(guī)范，充分利用常用的CASE工具，準(zhǔn)確地描述用戶需求、設(shè)計(jì)思路與算法，結(jié)合文字、圖形等多種展現(xiàn)形式，形成規(guī)范性的文檔記錄。為了保證軟件文檔的質(zhì)量，根據(jù)《規(guī)范》，在培養(yǎng)學(xué)生文檔編寫能力的過程中，應(yīng)注意堅(jiān)持以下幾點(diǎn)要求。

（1）針對(duì)性：在文檔編寫前應(yīng)注意區(qū)分不同文檔針對(duì)的讀者對(duì)象群體，根據(jù)不同類型、不同層次的讀者，編寫更適應(yīng)他們需要的文檔。

（2）文檔種類間內(nèi)容的重復(fù)性：不同種類的文檔內(nèi)容相互之間允許存在一定的重復(fù)，為了方便讀者，每種文檔應(yīng)該自成體系，盡量避免在讀一種文檔時(shí)必須參閱另一種文檔的現(xiàn)象。

（3）規(guī)范性：所有的文檔必須按照《規(guī)范》規(guī)定的內(nèi)容格式編寫，一般不得變動(dòng)章節(jié)的標(biāo)題和順序，各層次的條目可以根據(jù)實(shí)際需要細(xì)分、縮并或省略，新增加的條目應(yīng)加在原章節(jié)條目內(nèi)容的后面。

（4）精確性：文檔的描述應(yīng)該盡量準(zhǔn)確，不能出現(xiàn)多義性的描述。另外，同一項(xiàng)目中幾種文檔需要重復(fù)的內(nèi)容應(yīng)該協(xié)調(diào)一致、沒有矛盾。

（5）完整性：任何一篇文檔都應(yīng)該是完整和獨(dú)立的，可以自成體系。

2.2 文檔審查和評(píng)審能力

階段評(píng)審是軟件工程過程中的重要組成部分。軟件生命周期中的各個(gè)階段，都應(yīng)該堅(jiān)持嚴(yán)格的階段評(píng)審。由軟件文檔的重要性可知，文檔評(píng)審也是階段評(píng)審的重要工作內(nèi)容。因此，對(duì)學(xué)生文檔能力的培養(yǎng)，也體現(xiàn)在對(duì)學(xué)生文檔審查和評(píng)審能力的鍛煉和培養(yǎng)上，這可以加強(qiáng)學(xué)生對(duì)規(guī)范性文檔標(biāo)準(zhǔn)的認(rèn)識(shí)和理解，進(jìn)一步提升學(xué)生的文檔編寫能力。文檔審查和評(píng)審能力的培養(yǎng)主要要求學(xué)生能對(duì)自己或者他人撰寫的軟件文檔，從文檔結(jié)構(gòu)的規(guī)范性和合理性、文檔內(nèi)容的完整性和一致性、語言表述的準(zhǔn)確性等角度進(jìn)行分析和判斷，并作出合理化的建議性描述。

3、文檔能力培養(yǎng)實(shí)踐

軟件文檔是軟件產(chǎn)品的重要組成部分，也緊密依托于軟件產(chǎn)品，要培養(yǎng)學(xué)生的文檔能力，必須在項(xiàng)目任務(wù)中加以鍛煉。為此，我們把對(duì)學(xué)生文檔能力的培養(yǎng)融入項(xiàng)目開發(fā)與管理的整個(gè)過程中，以項(xiàng)目為導(dǎo)向，以實(shí)踐為驅(qū)動(dòng)，強(qiáng)調(diào)文檔在軟件整個(gè)生命周期中的地位和作用，堅(jiān)持文檔的規(guī)范性、全面性和準(zhǔn)確性要求，堅(jiān)持嚴(yán)格的階段性評(píng)審和復(fù)審，培養(yǎng)學(xué)生重視文檔、編寫文檔和審查文檔的綜合能力，主要從幾方面對(duì)軟件工程教學(xué)作出改革和創(chuàng)新的嘗試。

3.1 搭建開放的工程實(shí)踐環(huán)境

實(shí)踐環(huán)境是保證實(shí)驗(yàn)教學(xué)和質(zhì)量的基本條件，對(duì)于軟件工程課程顯得尤為重要。項(xiàng)目開發(fā)不是簡單的程序設(shè)計(jì)，而是軟件工程全過程的綜合性實(shí)踐，應(yīng)該建立和配置相應(yīng)的軟件工程實(shí)驗(yàn)環(huán)境或?qū)嶒?yàn)中心。同時(shí)，就軟件工程而言，它關(guān)注的是大型程序的構(gòu)造，強(qiáng)調(diào)團(tuán)隊(duì)合作。就學(xué)生的認(rèn)識(shí)而言，糾正軟件開發(fā)的個(gè)人英雄主義和單兵作戰(zhàn)的錯(cuò)誤思想極其重要，因此這就要求必須有一個(gè)支持團(tuán)隊(duì)協(xié)作、數(shù)據(jù)共享的信息平臺(tái)。endprint

西南民族大學(xué)計(jì)算機(jī)科學(xué)與技術(shù)學(xué)院于2011年8月創(chuàng)建了學(xué)生軟件創(chuàng)新基地。基地實(shí)驗(yàn)中心配置有專門的文檔服務(wù)器，搭建了軟件協(xié)作開發(fā)與管理平臺(tái)，學(xué)生在這里擁有良好的軟件開發(fā)和團(tuán)隊(duì)合作環(huán)境。基地提供了一個(gè)開放式的工程實(shí)踐平臺(tái)，希望得到進(jìn)一步學(xué)習(xí)和實(shí)踐鍛煉的學(xué)生可以自愿加入這個(gè)團(tuán)隊(duì)，由專門的指導(dǎo)教師根據(jù)學(xué)生的特點(diǎn)和技術(shù)特長進(jìn)行分組，組織和指導(dǎo)學(xué)生進(jìn)行軟件項(xiàng)目的開發(fā)實(shí)踐。

3.2 教學(xué)環(huán)節(jié)的改革與實(shí)踐

在教學(xué)環(huán)節(jié)上，我們也必須對(duì)軟件工程課程的教學(xué)體系進(jìn)行工程化改造，以便逐步建立工程化實(shí)踐教學(xué)體系，著力培養(yǎng)學(xué)生的工程化開發(fā)能力和職業(yè)素質(zhì)，進(jìn)而形成一個(gè)將理論基礎(chǔ)、實(shí)驗(yàn)教學(xué)、工程實(shí)踐融為一體的整體化培養(yǎng)機(jī)制。同時(shí)，必須把文檔的重要性及早在學(xué)生的意識(shí)觀念中建立起來，避免“重代碼、輕文檔”的錯(cuò)誤觀念先入為主，并在隨后的教學(xué)中繼續(xù)逐步提升學(xué)生的文檔能力。

3.2.1 C語言課程設(shè)計(jì)

c語言課程設(shè)計(jì)是計(jì)算機(jī)科學(xué)與技術(shù)學(xué)院從2008年上學(xué)期開始新開設(shè)的一門專業(yè)選修課，目的是進(jìn)一步增強(qiáng)學(xué)生的實(shí)際動(dòng)手編程能力，逐步培養(yǎng)并提升學(xué)生的邏輯思維能力。

作為大一上學(xué)期程序設(shè)計(jì)課程的延續(xù)，該課程不僅強(qiáng)調(diào)學(xué)生對(duì)C語言中基本語法的掌握程度和動(dòng)手編寫代碼的能力，同時(shí)更加注重學(xué)生邏輯思維能力的提高以及對(duì)解決問題思路和方案的清晰描述。在講解疑難題目時(shí)，通過繪制流程圖或者列出輔助表格幫助學(xué)生把握規(guī)律和理清思路；在糾正學(xué)生程序中的錯(cuò)誤時(shí)，不直接給出正確答案或告訴學(xué)生應(yīng)如何修改，而是先請(qǐng)學(xué)生講出自己的思路，再按照該思路梳理每個(gè)步驟間的邏輯關(guān)系和內(nèi)在聯(lián)系，引導(dǎo)學(xué)生重新審視自己的設(shè)計(jì)，找出其中的錯(cuò)誤根源。

通過此過程，學(xué)生逐漸認(rèn)識(shí)到語法和代碼只是一個(gè)程序中最基礎(chǔ)的部分，而算法和思路才是整個(gè)程序的靈魂，為今后重視前期設(shè)計(jì)做好鋪墊。同時(shí)，學(xué)生也開始逐步嘗試和學(xué)會(huì)使用算法流程圖等工具描述和記錄他們的解題思路，而這些工具也正是后期學(xué)生接觸到軟件工程課程甚至進(jìn)行軟件項(xiàng)目開發(fā)實(shí)踐時(shí)用于完成設(shè)計(jì)和編寫文檔的利器。

從筆者5年來的教學(xué)歷史和教學(xué)經(jīng)驗(yàn)看，大部分學(xué)生用4-6周時(shí)間就能在很大程度上對(duì)上學(xué)期所學(xué)的c語言基本語法加以鞏固，完成其中相對(duì)比較基礎(chǔ)的簡單計(jì)算題，后期則逐漸把學(xué)習(xí)重點(diǎn)轉(zhuǎn)移到知識(shí)擴(kuò)展和能力提升上。C語言課程設(shè)計(jì)鞏固了學(xué)生的程序編寫能力，同時(shí)讓學(xué)生潛移默化地認(rèn)識(shí)到程序設(shè)計(jì)并不僅僅是編寫代碼，為其今后正確認(rèn)識(shí)軟件工程和培養(yǎng)其文檔編寫能力打下了良好的基礎(chǔ)。

3.2.2 軟件工程概論

軟件工程概論是一門重要的專業(yè)基礎(chǔ)課程，具有很強(qiáng)的理論性和實(shí)踐性，其教學(xué)目標(biāo)是讓學(xué)生熟練掌握軟件開發(fā)的原理、技術(shù)和方法，具備獨(dú)立或合作完成軟件項(xiàng)目開發(fā)所需要的邏輯思維、溝通合作、表達(dá)寫作以及組織管理能力。然而，由于該課程內(nèi)容多，涵蓋面廣，并且包含了大量抽象的概念和原理，容易使學(xué)生感覺到枯燥乏味；另一方面，迫于課時(shí)壓力，教師在授課過程中往往會(huì)降低教學(xué)難度，將課堂講授的重點(diǎn)放在基本概念和原理上，沒有機(jī)會(huì)讓學(xué)生接觸到較為真實(shí)和復(fù)雜的項(xiàng)目。再加上很多學(xué)生長久以來持有軟件開發(fā)就是編寫代碼的錯(cuò)誤觀點(diǎn)，輕視分析、設(shè)計(jì)、測試與管理，導(dǎo)致課程的教學(xué)目標(biāo)很難達(dá)到。

從2010年起，計(jì)算機(jī)科學(xué)與技術(shù)學(xué)院為軟件工程概論課程增加22個(gè)上機(jī)課時(shí)，同時(shí)引入以項(xiàng)目為導(dǎo)向的軟件工程教學(xué)模式。一方面，在課堂講授上，教師結(jié)合實(shí)際案例和真實(shí)的開發(fā)經(jīng)驗(yàn)和教訓(xùn)為學(xué)生講解抽象的概念和原理，便于學(xué)生接受。同時(shí)，根據(jù)學(xué)生的自愿選擇有指導(dǎo)性地將所有學(xué)生劃分為若干小組，每個(gè)小組獨(dú)立承擔(dān)一個(gè)項(xiàng)目。另一方面，教師根據(jù)教學(xué)需要?jiǎng)澐周浖_發(fā)的各個(gè)階段和相應(yīng)的階段任務(wù)，由各個(gè)小組內(nèi)部協(xié)調(diào)細(xì)分到每位組員。每個(gè)小組在協(xié)作完成該階段的任務(wù)后向教師提交階段性成果，由教師進(jìn)行審查和記錄。

在項(xiàng)目驅(qū)動(dòng)的特定教學(xué)環(huán)境中，學(xué)生在實(shí)際項(xiàng)目的驅(qū)動(dòng)下，帶著問題學(xué)習(xí)理論和開發(fā)技術(shù)，在項(xiàng)目實(shí)踐中鍛煉思維能力、問題求解能力和處理復(fù)雜任務(wù)的能力。由于文檔貫穿于軟件開發(fā)的整個(gè)生命周期，學(xué)生在進(jìn)行軟件開發(fā)的過程中，查閱了大量關(guān)于文檔編寫的資料，掌握了軟件文檔編寫的基本框架結(jié)構(gòu)和一些文檔輔助生成工具的使用技巧。教師在收到學(xué)生提交的文檔后，對(duì)文檔進(jìn)行仔細(xì)審查并及時(shí)提出修改意見和建議，幫助學(xué)生提高文檔質(zhì)量。對(duì)于其中典型的和有代表f生的設(shè)計(jì)開發(fā)文檔，教師還可以組織全體學(xué)生在課堂上以講解——提問—答疑的形式一起進(jìn)行討論和評(píng)審，既活躍了課堂氣氛，拉近了師生之間的距離，又加深了學(xué)生對(duì)于軟件工程過程的認(rèn)識(shí)，提高了學(xué)生的文檔能力。

3.2.3 學(xué)生創(chuàng)新實(shí)踐

項(xiàng)目教學(xué)、案例驅(qū)動(dòng)等新教學(xué)模式的引入，使學(xué)生通過課堂上的學(xué)習(xí)和項(xiàng)目上的體驗(yàn)，真實(shí)地感受到軟件生命周期從需求采集、建模設(shè)計(jì)到最后軟件測試中的各個(gè)環(huán)節(jié)，幫助學(xué)生建立起對(duì)軟件工程過程的感性認(rèn)識(shí)，增強(qiáng)學(xué)生的文檔能力，但同時(shí)我們也必須要認(rèn)識(shí)到，學(xué)生通過課程學(xué)習(xí)和體驗(yàn)到的相關(guān)知識(shí)，與他們畢業(yè)后即將從事實(shí)際行業(yè)的要求和規(guī)范之間，仍然存在著很大的差距。Nurkkala和Brandle對(duì)現(xiàn)行的軟件工程教育和行業(yè)內(nèi)的現(xiàn)狀進(jìn)行了深入研究和對(duì)比分析，指出因?yàn)槭艿綄?shí)際教學(xué)環(huán)節(jié)中各種因素的制約，適用于教學(xué)的虛擬項(xiàng)目和行業(yè)中的實(shí)際項(xiàng)目相比，差距主要體現(xiàn)在沒有真實(shí)產(chǎn)品、持續(xù)時(shí)間短、流動(dòng)性高、復(fù)雜性低、缺乏維護(hù)和沒有實(shí)際客戶6個(gè)方面，而項(xiàng)目上的差異也最終導(dǎo)致了學(xué)生對(duì)軟件產(chǎn)品、軟件工程過程認(rèn)識(shí)不足，并形成了輕視文檔，認(rèn)為開發(fā)過程的結(jié)束就是整個(gè)軟件項(xiàng)目的終結(jié)等錯(cuò)誤觀念。

學(xué)生軟件創(chuàng)新基地則部分克服了上述這些因受到教學(xué)安排等限制而導(dǎo)致的不足之處，因而也在一定程度上解決了教育現(xiàn)狀和行業(yè)要求嚴(yán)重脫節(jié)的問題。首先，因?yàn)閷W(xué)生軟件創(chuàng)新基地相對(duì)獨(dú)立于學(xué)校規(guī)定的教學(xué)環(huán)節(jié)安排，因此具有較長的持續(xù)時(shí)間，從學(xué)生的角度而言，學(xué)生可以根據(jù)自己的愛好、特長在教師指導(dǎo)下自愿加入或退出創(chuàng)新基地，有比較充分的時(shí)間參與項(xiàng)目實(shí)踐，提高文檔能力和項(xiàng)目管理能力；從項(xiàng)目的角度而言，因?yàn)椴辉偈艿綄W(xué)期、學(xué)年的限制，項(xiàng)目開發(fā)周期可以更長，甚至可以包含軟件的上線測試和運(yùn)營維護(hù)等開發(fā)后續(xù)階段。其次，創(chuàng)新基地中的學(xué)生是跨年級(jí)的，已有實(shí)踐經(jīng)驗(yàn)的學(xué)生和新加入的學(xué)生可以在基地中共存，甚至在同一項(xiàng)目組中一起承擔(dān)項(xiàng)目子任務(wù)。因此，人力資源相對(duì)穩(wěn)定，新舊人員可以平穩(wěn)過渡，學(xué)生通過討論、交流、文檔評(píng)審等互動(dòng)活動(dòng)，從實(shí)踐中體會(huì)項(xiàng)目開發(fā)、文檔撰寫過程，令經(jīng)驗(yàn)得到積累、延續(xù)和不斷擴(kuò)展。最后，由于人員穩(wěn)定性較強(qiáng)，技術(shù)、經(jīng)驗(yàn)?zāi)軌虻玫椒e累，因此能夠完成項(xiàng)目的復(fù)雜度也可以適當(dāng)?shù)刂饾u提升，而開發(fā)出來的軟件產(chǎn)品也可以進(jìn)行維護(hù)。

學(xué)生在創(chuàng)新基地的工作和軟件工程概論課程基本類似，由于時(shí)間和人力資源更加充分，技術(shù)水平也有一定的積累，因此相應(yīng)的區(qū)別主要體現(xiàn)在兩個(gè)方面：①接觸的項(xiàng)目更加復(fù)雜和真實(shí)，有時(shí)甚至是來源于校外企業(yè)的真實(shí)項(xiàng)目，開發(fā)周期也更長；②階段評(píng)審尤其是文檔評(píng)審也更加嚴(yán)格，有時(shí)一篇文檔甚至要評(píng)審、修改、復(fù)審好幾次。在這樣的鍛煉中，學(xué)生對(duì)自己的要求也更加嚴(yán)格，對(duì)文檔的撰寫方法和技巧更加熟悉，對(duì)文檔的把握也更加準(zhǔn)確。

4、文檔能力培養(yǎng)成果

近4年來，通過在教學(xué)改革過程中的不斷摸索和嘗試，結(jié)合以項(xiàng)目為導(dǎo)向的“講授——引導(dǎo)——項(xiàng)目演練——交流總結(jié)”教學(xué)模式，我們總結(jié)出一些培養(yǎng)學(xué)生文檔能力的教學(xué)經(jīng)驗(yàn)和方法，并初步取得了一些成果。

（1）一部分學(xué)生尤其是創(chuàng)新基地學(xué)生的文檔能力得到顯著提高，這些學(xué)生對(duì)于文檔的結(jié)構(gòu)、內(nèi)容組織和安排、編寫技巧等已有較好的基礎(chǔ)，并且會(huì)使用一些常用的計(jì)算機(jī)輔助設(shè)計(jì)工具配合編寫文檔。

（2）到目前為止，創(chuàng)新基地的學(xué)生已完成校外企業(yè)級(jí)項(xiàng)目2個(gè)、自立項(xiàng)目3個(gè)，在2個(gè)開發(fā)項(xiàng)目過程中共產(chǎn)生大小40余篇軟件文檔，包括需求規(guī)格說明書、概要設(shè)計(jì)文檔、數(shù)據(jù)庫設(shè)計(jì)文檔、用戶手冊、現(xiàn)場安裝部署文檔等，其中包含10余篇基本符合企業(yè)規(guī)范的正式軟件文檔。

（3）創(chuàng)新基地中的部分學(xué)生通過近3年的訓(xùn)練，在就業(yè)后具有較高的文檔編制能力，對(duì)軟件工程也有較深入的認(rèn)識(shí)，并且具備了分析和設(shè)計(jì)軟件的基本能力，得到了所在單位的肯定。

5、結(jié)語

文檔對(duì)于軟件工程的重要作用決定了對(duì)學(xué)生文檔能力的培養(yǎng)是軟件工程教學(xué)過程中一個(gè)非常重要的環(huán)節(jié)。一方面，教師要通過案例教學(xué)的方式讓學(xué)生意識(shí)到文檔的重要性，糾正“重代碼、輕文檔”的錯(cuò)誤觀念；另一方面，要結(jié)合項(xiàng)目驅(qū)動(dòng)的教學(xué)模式在項(xiàng)目中加強(qiáng)對(duì)學(xué)生文檔寫作能力、審核和評(píng)審能力的鍛煉和培養(yǎng)，幫助學(xué)生逐漸養(yǎng)成編制文檔、評(píng)審文檔、管理文檔和使用文檔的習(xí)慣，加深對(duì)軟件工程的理解和把握，提高軟件開發(fā)的綜合素質(zhì)和能力。endprint