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

及時(shí)更新網(wǎng)站文檔

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

即使在一些有著穩(wěn)健和健康的文檔編寫文化的組織中,應(yīng)用的進(jìn)化和修改速度也會遠(yuǎn)遠(yuǎn)快于文檔編寫速度?,F(xiàn)實(shí)情況是軟件變化速度遠(yuǎn)遠(yuǎn)快于文檔編寫速度,即使有自動化文檔系統(tǒng),有時(shí)候我們?nèi)匀恍枰斯ぞ帉懸恍┪臋n。這種文檔需要通過一定的技術(shù)轉(zhuǎn)換,方能提供給在特殊閱讀環(huán)境中的讀者閱讀,因此無法通過自動化方法維護(hù)。
API參考文檔以及其他高度技術(shù)化的文檔,則很可能通過編程語言平臺的自動化文檔編寫機(jī)制完成(如Java的 Javadoc、Ruby的RDoc Python的 Pydoc等)。然而,有些需要人類表達(dá)(這是最寶貴的交流方式)的文檔,則不像技術(shù)文檔一樣與應(yīng)用程序和基礎(chǔ)架構(gòu)有緊密關(guān)系。為此,技術(shù)文檔可能在一個(gè)月內(nèi)(或更短的時(shí)間內(nèi))就會過期,而有一些文檔可能幾年時(shí)間都未曾更新過一一不過,這種情況實(shí)際上比沒有技術(shù)文檔還要槽,因?yàn)闀M(jìn)上程帥以為不需要從別處獲取信息,而誤認(rèn)為這些過期文檔就是正確的信息。

除此之外,當(dāng)文檔創(chuàng)建后,許多工程師就不會再更新文檔了。定期檢查文檔才能讓文檔保持最新狀態(tài)。
解決方法:通知工程師更新文檔
在整個(gè)組織范圍內(nèi),人們不太可能詳細(xì)閱讀文檔管理系統(tǒng)(如Wi) 中的所有文檔,但在一個(gè)部門級別上,卻可能會出現(xiàn)一些文檔修改和編輯。但是,使用隨機(jī)方法的效率是遠(yuǎn)遠(yuǎn)不夠的,我們必須通過某種機(jī)制,讓文檔管理系統(tǒng)能夠通知文檔所有人或管理員,讓他們在一段時(shí)間后更新文檔。開源Wiki系統(tǒng) Twiki提出了一種解決方案,它的頁面像報(bào)紙一樣在時(shí)間長了之后會變黃。而且,在系統(tǒng)認(rèn)為文檔可能需要更新時(shí),它會向文檔所有人發(fā)送一封通知郵件。
但只有工具還不夠,運(yùn)維與開發(fā)團(tuán)隊(duì)還必須轉(zhuǎn)變認(rèn)識,他們必須將使用文檔視為一種軟件改進(jìn)手段。例如,需要更新的頁面會變成黃色但這并不意味著有人會去更新它。必須有人去響應(yīng)這個(gè)通知,如果接收者不理解創(chuàng)建及維護(hù)文檔對于代碼和系統(tǒng)的價(jià)值,那么這個(gè)響應(yīng)可能就不會出現(xiàn)。如果技術(shù)人員知道當(dāng)文檔需要更新時(shí),系統(tǒng)才會通知他們,那么當(dāng)他們接收到一個(gè)通知時(shí),他們就很可能會跟進(jìn)處理這個(gè)通知。這似乎有一些瑣碎,但是對技術(shù)人員予以告知可以鼓勵(lì)他們認(rèn)真對待文檔。
好處:將文檔整合到常規(guī)活動中
當(dāng)網(wǎng)站設(shè)計(jì)開發(fā)人員習(xí)慣了接收更新通知并響應(yīng)這些通知之后,他們就會看到文檔在改進(jìn)軟件方面的價(jià)值,這樣將進(jìn)一步激勵(lì)他們及時(shí)響應(yīng)通知。構(gòu)成大型網(wǎng)站基礎(chǔ)架構(gòu)的軟硬件通常由一定數(shù)量的位于數(shù)據(jù)中心內(nèi)的服務(wù)器組成。目前,這些基礎(chǔ)架構(gòu)的安裝及維護(hù)在一定程度上仍然通過人工方式完成。我們將介紹隨著計(jì)算領(lǐng)域內(nèi)的突破性進(jìn)展,虛擬化基礎(chǔ)架構(gòu)是如何減少人工需求的,以及如何實(shí)現(xiàn)其中一些流程的自動化。不過,在考慮實(shí)施自動化之前,最好先了解一下當(dāng)前的工作流程。

網(wǎng)站欄目:及時(shí)更新網(wǎng)站文檔
本文網(wǎng)址:http://www.rwnh.cn/news/150174.html

成都網(wǎng)站建設(shè)公司_創(chuàng)新互聯(lián),為您提供做網(wǎng)站、微信公眾號標(biāo)簽優(yōu)化、商城網(wǎng)站微信小程序、外貿(mào)建站

廣告

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

成都seo排名網(wǎng)站優(yōu)化
出国| 赣榆县| 渝中区| 开原市| 那坡县| 安吉县| 西昌市| 耒阳市| 南部县| 云林县| 大冶市| 闵行区| 桐柏县| 东乡| 白朗县| 句容市| 松溪县| 卓资县| 乐东| 鹤庆县| 双牌县| 铜山县| 富锦市| 富阳市| 连州市| 马尔康县| 富裕县| 固阳县| 浮梁县| 金秀| 乌兰县| 阜阳市| 老河口市| 兴宁市| 田阳县| 达孜县| 集贤县| 沧州市| 台前县| 徐闻县| 南江县|