<big id="n3dbt"><strong id="n3dbt"></strong></big>
      1. <small id="n3dbt"><delect id="n3dbt"></delect></small>

        <thead id="n3dbt"><ruby id="n3dbt"><rp id="n3dbt"></rp></ruby></thead>
        <th id="n3dbt"></th>
        <span id="n3dbt"></span><span id="n3dbt"></span><span id="n3dbt"></span><strike id="n3dbt"></strike>

        建站百科Website News

        當前位置:首頁 »西安網站建設公司如何編寫面向受眾的網站文檔?

        西安網站建設公司如何編寫面向受眾的網站文檔?

        至成科技 2019-02-18 訪問量(198) 評論(0)
        摘要:一個西安網站建設公司組織不可能只有高級軟件工程師或系統管理員,所以,只有基于特定規范的文檔就意味著只有高級技術人員才能閱讀這些文檔。這是一種機能障礙問題。當然,這些文檔也是必要和重要的,這已經比只有閱讀代碼才能了解應用程序的情況好很多了。然而,這并不是一種完整的文檔戰略與文化。 解決方法:編寫面向受眾的文檔   如何解…

        一個西安網站建設公司組織不可能只有高級軟件工程師或系統管理員,所以,只有基于特定規范的文檔就意味著只有高級技術人員才能閱讀這些文檔。這是一種機能障礙問題。當然,這些文檔也是必要和重要的,這已經比只有閱讀代碼才能了解應用程序的情況好很多了。然而,這并不是一種完整的文檔戰略與文化。

         

        解決方法:編寫面向受眾的文檔

          

         如何解讀一種特定類型的文檔取決于個人在組織中的位置。例如,安網站建設公司對于系統管理員而言,API參考文檔毫無用處,對高級系統管理員也樣。他們不可能花時間去閱讀API參考文檔,更不用說讓他們解釋或使用API參考文檔去改進運維過程了。系統管理員需要的是面向系統管理員環境編寫的文檔。這種文檔本身可能會包含很多來自API參考文檔的信息,但是這個文檔不應該只羅列函數,還應該包含其他一些信息,如API可以支持多少個請求,它使用什么網絡協議,以及它依賴哪些軟件,等等。這樣才能幫助系統管理員理解如何部署應用程序,從而知道應在服務器環境中部署哪些組件。在這種情況下,我們會先從API參考文檔開始,然后給出面向兩種讀者的兩個具體的API實現文檔:運維指南和開發指南。

          

         編寫面向不同受眾的完整文檔集,讓文檔成為一個團隊文化的鮮活部分。一定要理解需要使用文檔的受眾,如業務用戶、系統管理員、數據庫管理員、軟件開發人員、網絡工程師、項目經理,等等。對于業務用戶而言,或許API規范需要考慮所支持的每種應用的開銷成本;而對于網絡工程師來說,則可能需要說明應用程序使用了哪些協議。應該編寫哪一種文檔,并沒有一種固定模式,而完全取決于業務及團隊的需要。

          

         好處:強化不同團隊之間的紐帶

          

         西安網站建設公司面向不同受眾編寫文檔,其結果必然能夠優化人們對于業務雙方的理解,減少誤解和錯誤,并且減少雙方的壓力。而且,我們可以在一個文檔的基礎上編寫另一個文檔。例如,在了解網站建設應用程序及運維基礎架構(服務器、網絡設備等)的功能與限制之后,我們就可以在維護、功能規劃成本及可擴展性指標上使用這些信息。如果一個文檔可以利用另一個文檔,那么編寫文檔的時間就會大大減少。這種方式不一定適用于所有情況,但是很多時候都是這樣的。


        網友評論

        登錄后可評論,請登錄

        全部評論:0條

        掃描左側二維碼
        關注至成微信公眾號

        西安至成信息科技有限公司  Copyright 2012-2019  xazcit.com  All rights reserved.

        Email:[email protected]     郵政編碼:710016     《中華人民共和國增值電信業務經營許可證》陜B1.B2-20140011     陜ICP備12008874號-1

        聯系地址:西安市經開區鳳城四路西安國際企業中心B座23層06-10室    售前咨詢熱線:029-89390727    售后服務電話:029-89393039

        西安網站建設、網站設計制作公司-至成科技,已為眾多企業提供網站建設網站制作響應式網站設計手機網站建設虛擬主機云主機服務器租用等建站解決方案。

        網絡警察 12321垃圾信息舉報 不良信息舉報 中國文明網 西安工商
        ×
        安徽25选5计划