• 鲜琦:感恩父亲节,永远难忘父亲这首歌(3) 2019-11-12
  • 中共中央文件选集一(1921―1925) 2019-11-08
  • 一代枭雄身后事:“曹操墓”认定过程缘何一波三折? 2019-10-28
  • 打造上合组织命运共同体 成员国应积极推动理念与实践 2019-10-28
  • 市场能调节供需平衡吗? 2019-10-26
  • 俄政府拟逐步提高退休年龄 总理呼吁各方支持 2019-10-26
  • 女白领不是将自己嘴里吃剩的饭连口水一起打包的,而是将桌上的,人们没吃的留给了贫寒者,这有什么错? 2019-10-22
  • 金正恩对中国进行访问 2019-10-14
  • 【中国梦·大国工匠篇】 “跨界”复苏失传百年工艺 蔺涛:坚守让古砚焕发新生 2019-10-12
  • 弥渡 万亩梨花如云似瀑 春城壹网 七彩云南 一网天下 2019-10-11
  • 山西太原:丽人演绎“插秧”美景 2019-10-11
  • 河南一矿企收33张罚单仍违法排污 有基层官员站台 2019-10-09
  • 《英雄联盟》2018职业联赛春季赛决赛28日首发阵容公布 2019-10-09
  • 弘扬“上海精神” 破解时代难题 2019-10-08
  • 专访古惠南:广汽新能源打造15分钟纯电出行圈 2019-10-08
  • 天龙八部手游卡牌获得:建站百科Website News

    当前位置:天龙八部手游珍兽称号 »西安网站建设公司如何编写面向受众的网站文档?

    西安网站建设公司如何编写面向受众的网站文档?

    至成科技 2019-02-18 访问量(437) 评论(0)
    摘要:一个西安网站建设公司组织不可能只有高级软件工程师或系统管理员,所以,只有基于特定规范的文档就意味着只有高级技术人员才能阅读这些文档。这是一种机能障碍问题。当然,这些文档也是必要和重要的,这已经比只有阅读代码才能了解应用程序的情况好很多了。然而,这并不是一种完整的文档战略与文化。 解决方法:编写面向受众的文档   如何解…

    天龙八部手游珍兽称号 www.nqvh.top 一个西安网站建设公司组织不可能只有高级软件工程师或系统管理员,所以,只有基于特定规范的文档就意味着只有高级技术人员才能阅读这些文档。这是一种机能障碍问题。当然,这些文档也是必要和重要的,这已经比只有阅读代码才能了解应用程序的情况好很多了。然而,这并不是一种完整的文档战略与文化。

     

    解决方法:编写面向受众的文档

      

     如何解读一种特定类型的文档取决于个人在组织中的位置。例如,安网站建设公司对于系统管理员而言,API参考文档毫无用处,对高级系统管理员也样。他们不可能花时间去阅读API参考文档,更不用说让他们解释或使用API参考文档去改进运维过程了。系统管理员需要的是面向系统管理员环境编写的文档。这种文档本身可能会包含很多来自API参考文档的信息,但是这个文档不应该只罗列函数,还应该包含其他一些信息,如API可以支持多少个请求,它使用什么网络协议,以及它依赖哪些软件,等等。这样才能帮助系统管理员理解如何部署应用程序,从而知道应在服务器环境中部署哪些组件。在这种情况下,我们会先从API参考文档开始,然后给出面向两种读者的两个具体的API实现文档:运维指南和开发指南。

      

     编写面向不同受众的完整文档集,让文档成为一个团队文化的鲜活部分。一定要理解需要使用文档的受众,如业务用户、系统管理员、数据库管理员、软件开发人员、网络工程师、项目经理,等等。对于业务用户而言,或许API规范需要考虑所支持的每种应用的开销成本;而对于网络工程师来说,则可能需要说明应用程序使用了哪些协议。应该编写哪一种文档,并没有一种固定模式,而完全取决于业务及团队的需要。

      

     好处:强化不同团队之间的纽带

      

     西安网站建设公司面向不同受众编写文档,其结果必然能够优化人们对于业务双方的理解,减少误解和错误,并且减少双方的压力。而且,我们可以在一个文档的基础上编写另一个文档。例如,在了解网站建设应用程序及运维基础架构(服务器、网络设备等)的功能与限制之后,我们就可以在维护、功能规划成本及可扩展性指标上使用这些信息。如果一个文档可以利用另一个文档,那么编写文档的时间就会大大减少。这种方式不一定适用于所有情况,但是很多时候都是这样的。


    网友评论

    登录后可评论,请登录

    全部评论:0条

    扫描左侧二维码
    关注至成微信公众号

    西安至成信息科技有限公司  Copyright 2012-2019  天龙八部手游珍兽称号  All rights reserved.

    Email:[email protected]     邮政编码:710016     《中华人民共和国增值电信业务经营许可证》陕B1.B2-20140011     陕ICP备12008874号-1

    联系地址:西安市经开区凤城四路西安国际企业中心B座23层06-10室    售前咨询热线:029-89390727    售后服务电话:029-89393039

    西安网站建设、网站设计制作公司-至成科技,已为众多企业提供网站建设,网站制作,响应式网站设计,手机网站建设,虚拟主机,云主机,服务器租用等建站解决方案。

    网络警察 12321垃圾信息举报 不良信息举报 中国文明网 西安工商
    ×
  • 鲜琦:感恩父亲节,永远难忘父亲这首歌(3) 2019-11-12
  • 中共中央文件选集一(1921―1925) 2019-11-08
  • 一代枭雄身后事:“曹操墓”认定过程缘何一波三折? 2019-10-28
  • 打造上合组织命运共同体 成员国应积极推动理念与实践 2019-10-28
  • 市场能调节供需平衡吗? 2019-10-26
  • 俄政府拟逐步提高退休年龄 总理呼吁各方支持 2019-10-26
  • 女白领不是将自己嘴里吃剩的饭连口水一起打包的,而是将桌上的,人们没吃的留给了贫寒者,这有什么错? 2019-10-22
  • 金正恩对中国进行访问 2019-10-14
  • 【中国梦·大国工匠篇】 “跨界”复苏失传百年工艺 蔺涛:坚守让古砚焕发新生 2019-10-12
  • 弥渡 万亩梨花如云似瀑 春城壹网 七彩云南 一网天下 2019-10-11
  • 山西太原:丽人演绎“插秧”美景 2019-10-11
  • 河南一矿企收33张罚单仍违法排污 有基层官员站台 2019-10-09
  • 《英雄联盟》2018职业联赛春季赛决赛28日首发阵容公布 2019-10-09
  • 弘扬“上海精神” 破解时代难题 2019-10-08
  • 专访古惠南:广汽新能源打造15分钟纯电出行圈 2019-10-08
  • 抢庄棋牌 广东11选5技巧规律 玩三公扑克牌作弊赌具 pk10走势图教程 新利棋牌开户送彩金 活着赚钱为了什么 经典麻将单机版手机 特区彩票网 长春小姐全套服务 打三公怎样才能赢钱 诸葛亮3肖6码主论坛 北京十一选五遗漏top 三级成人黄色片 共赢电子加工 能赚钱吗 时尚性感美女 日本最狠sm番号