中文字幕日韩精品一区二区免费_精品一区二区三区国产精品无卡在_国精品无码专区一区二区三区_国产αv三级中文在线

如何編寫面向受眾的網(wǎng)站文檔?

2022-05-07    分類: 網(wǎng)站建設(shè)

一個組織不可能只有高級軟件工程師或系統(tǒng)管理員,所以,只有基于特定規(guī)范的文檔就意味著只有高級技術(shù)人員才能閱讀這些文檔。這是一種機(jī)能障礙問題。當(dāng)然,這些文檔也是必要和重要的,這已經(jīng)比只有閱讀代碼才能了解應(yīng)用程序的情況好很多了。然而,這并不是一種完整的文檔戰(zhàn)略與文化。

解決方法:編寫面向受眾的文檔
如何解讀一種特定類型的文檔取決于個人在組織中的位置。例如,對于系統(tǒng)管理員而言,API參考文檔毫無用處,對高級系統(tǒng)管理員也樣。他們不可能花時間去閱讀API參考文檔,更不用說讓他們解釋或使用API參考文檔去改進(jìn)運(yùn)維過程了。系統(tǒng)管理員需要的是面向系統(tǒng)管理員環(huán)境編寫的文檔。這種文檔本身可能會包含很多來自API參考文檔的信息,但是這個文檔不應(yīng)該只羅列函數(shù),還應(yīng)該包含其他一些信息,如API可以支持多少個請求,它使用什么網(wǎng)絡(luò)協(xié)議,以及它依賴哪些軟件,等等。這樣才能幫助系統(tǒng)管理員理解如何部署應(yīng)用程序,從而知道應(yīng)在服務(wù)器環(huán)境中部署哪些組件。在這種情況下,我們會先從API參考文檔開始,然后給出面向兩種讀者的兩個具體的API實(shí)現(xiàn)文檔:運(yùn)維指南和開發(fā)指南。
編寫面向不同受眾的完整文檔集,讓文檔成為一個團(tuán)隊(duì)文化的鮮活部分。一定要理解需要使用文檔的受眾,如業(yè)務(wù)用戶、系統(tǒng)管理員、數(shù)據(jù)庫管理員、軟件開發(fā)人員、網(wǎng)絡(luò)工程師、項(xiàng)目經(jīng)理,等等。對于業(yè)務(wù)用戶而言,或許API規(guī)范需要考慮所支持的每種應(yīng)用的開銷成本;而對于網(wǎng)絡(luò)工程師來說,則可能需要說明應(yīng)用程序使用了哪些協(xié)議。應(yīng)該編寫哪一種文檔,并沒有一種固定模式,而完全取決于業(yè)務(wù)及團(tuán)隊(duì)的需要。
好處:強(qiáng)化不同團(tuán)隊(duì)之間的紐帶
面向不同受眾編寫文檔,其結(jié)果必然能夠優(yōu)化人們對于業(yè)務(wù)雙方的理解,減少誤解和錯誤,并且減少雙方的壓力。而且,我們可以在一個文檔的基礎(chǔ)上編寫另一個文檔。例如,在了解網(wǎng)站建設(shè)應(yīng)用程序及運(yùn)維基礎(chǔ)架構(gòu)(服務(wù)器、網(wǎng)絡(luò)設(shè)備等)的功能與限制之后,我們就可以在維護(hù)、功能規(guī)劃成本及可擴(kuò)展性指標(biāo)上使用這些信息。如果一個文檔可以利用另一個文檔,那么編寫文檔的時間就會大大減少。這種方式不一定適用于所有情況,但是很多時候都是這樣的。

網(wǎng)站標(biāo)題:如何編寫面向受眾的網(wǎng)站文檔?
當(dāng)前路徑:http://m.rwnh.cn/news44/151044.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供Google、網(wǎng)站設(shè)計(jì)公司微信公眾號、ChatGPT營銷型網(wǎng)站建設(shè)、網(wǎng)站內(nèi)鏈

廣告

聲明:本網(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)

網(wǎng)站優(yōu)化排名
昭觉县| 若尔盖县| 基隆市| 肥西县| 通州市| 余姚市| 昂仁县| 肃南| 渭南市| 绵阳市| 新丰县| 贺州市| 乐业县| 景宁| 二连浩特市| 高唐县| 瑞安市| 利津县| 砚山县| 济宁市| 旺苍县| 渝中区| 丽江市| 青阳县| 巧家县| 焦作市| 清徐县| 昭觉县| 新兴县| 嘉黎县| 于田县| 赫章县| 纳雍县| 黎城县| 莒南县| 建宁县| 新邵县| 揭东县| 玉龙| 宁国市| 奉化市|