其實(shí)，并非所有人都能夠讀懂API或配置管理清單。業(yè)務(wù)用戶、項目經(jīng)理及其他非技術(shù)人員經(jīng)常需要了解應(yīng)用程序的內(nèi)部工作方式，這樣他們才能更好地完成自己的工作，而技術(shù)文檔并不能滿足他們的需求。這些輔助人員是T組織正常運(yùn)行的重要條件，如果沒有這些信息，他們就會感到被疏遠(yuǎn)，不知道該如何與開發(fā)和運(yùn)維團(tuán)隊交流，或者也不知道如何將他們的工作傳達(dá)給業(yè)務(wù)部門、項目管理部門或其他非技術(shù)部門。

此外，還有一種借口:由于軟件開發(fā)速度越來越快，所以開發(fā)人員和運(yùn)維人員需要進(jìn)一步提高生產(chǎn)力，減少交叉培訓(xùn)、編寫文檔和內(nèi)部培訓(xùn)的時間。這同樣也是不對的。如果沒有文檔，我們就無法將遺留系統(tǒng)引入組織中。遺留系統(tǒng)通常是每隔幾年就需要更新一次，因?yàn)橹廊绾尉S護(hù)這些系統(tǒng)的人可能已經(jīng)離開公司，或者根本不記得如何維護(hù)這些系統(tǒng)，也沒有參考資料可以查閱。

解決方法:將文檔加到成功條件中，共同分擔(dān)文檔編寫責(zé)任

大多數(shù)基于Web的組織都會使用一種敏捷或精益方法來開發(fā)軟件，而且這個過程通常需要定期極查已完成的上作和核對任務(wù)執(zhí)行情況，從而落實(shí)項目的進(jìn)展情況。這樣的話，文檔就可以整合到開發(fā)與運(yùn)維團(tuán)隊的文化中，而且組織也能夠從中獲益，例如產(chǎn)出質(zhì)量更好的代碼和發(fā)現(xiàn)設(shè)計問題等。

這個過程需要管理層的參與才能取得成功。如果管理層只關(guān)注于完成進(jìn)度，而不注意形成文檔編寫文化，那么這種過程是不可能成功的。只是認(rèn)同文檔屬于軟件開發(fā)生命周期的一部分，但不使用必要的文檔工具，也不投入時間，那么形成文檔編寫文化的目標(biāo)就不可能實(shí)現(xiàn)。

配備一位有技術(shù)背景的文檔編寫人員(技術(shù)文檔工程師)有利于鼓勵開發(fā)與運(yùn)維團(tuán)隊主動承擔(dān)起編寫代碼文檔、應(yīng)用文檔和流程文檔的責(zé)任。一位經(jīng)驗(yàn)豐富的技術(shù)文檔工程師可以指導(dǎo)他人編寫出有效的文檔，或者幫助他們養(yǎng)成編寫文檔的習(xí)慣。這樣可以幫助反對編寫文檔的工程師開始接受文檔編寫工作。

一旦每位成都網(wǎng)站建設(shè)制作工程師都愿意編寫自己的文檔，那么技術(shù)文檔工程師就可以將角色從布道師和寫手，轉(zhuǎn)變?yōu)榫庉嫼椭笇?dǎo)者，專職負(fù)責(zé)保證文檔的正確組織和發(fā)布，以及幫助工程師改進(jìn)技術(shù)文檔的質(zhì)量。

分享題目：成都網(wǎng)站建設(shè)制作時間不夠怎么辦
標(biāo)題來源：http://www.rwnh.cn/news29/313179.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián)，為您提供網(wǎng)站策劃、自適應(yīng)網(wǎng)站、網(wǎng)站設(shè)計、虛擬主機(jī)、網(wǎng)站排名、外貿(mào)建站

廣告

聲明：本網(wǎng)站發(fā)布的內(nèi)容（圖片、視頻和文字）以用戶投稿、用戶轉(zhuǎn)載內(nèi)容為主，如果涉及侵權(quán)請盡快告知，我們將會在第一時間刪除。文章觀點(diǎn)不代表本網(wǎng)站立場，如需處理請聯(lián)系客服。電話：028-86922220；郵箱：631063699@qq.com。內(nèi)容未經(jīng)允許不得轉(zhuǎn)載，或轉(zhuǎn)載時需注明來源： 創(chuàng)新互聯(lián)