2024-01-12 分类: 网站建设
其实,并非所有人都能够读懂API或配置管理清单。业务用户、项目经理及其他非技术人员经常需要了解应用程序的内部工作方式,这样他们才能更好地完成自己的工作,而技术文档并不能满足他们的需求。这些辅助人员是T组织正常运行的重要条件,如果没有这些信息,他们就会感到被疏远,不知道该如何与开发和运维团队交流,或者也不知道如何将他们的工作传达给业务部门、项目管理部门或其他非技术部门。
此外,还有一种借口:由于软件开发速度越来越快,所以开发人员和运维人员需要进一步提高生产力,减少交叉培训、编写文档和内部培训的时间。这同样也是不对的。如果没有文档,我们就无法将遗留系统引入组织中。遗留系统通常是每隔几年就需要更新一次,因为知道如何维护这些系统的人可能已经离开公司,或者根本不记得如何维护这些系统,也没有参考资料可以查阅。
解决方法:将文档加到成功条件中,共同分担文档编写责任
大多数基于Web的组织都会使用一种敏捷或精益方法来开发软件,而且这个过程通常需要定期極查已完成的上作和核对任务执行情况,从而落实项目的进展情况。这样的话,文档就可以整合到开发与运维团队的文化中,而且组织也能够从中获益,例如产出质量更好的代码和发现设计问题等。
这个过程需要管理层的参与才能取得成功。如果管理层只关注于完成进度,而不注意形成文档编写文化,那么这种过程是不可能成功的。只是认同文档属于软件开发生命周期的一部分,但不使用必要的文档工具,也不投入时间,那么形成文档编写文化的目标就不可能实现。
配备一位有技术背景的文档编写人员(技术文档工程师)有利于鼓励开发与运维团队主动承担起编写代码文档、应用文档和流程文档的责任。一位经验丰富的技术文档工程师可以指导他人编写出有效的文档,或者帮助他们养成编写文档的习惯。这样可以帮助反对编写文档的工程师开始接受文档编写工作。
一旦每位成都网站建设制作工程师都愿意编写自己的文档,那么技术文档工程师就可以将角色从布道师和写手,转变为编辑和指导者,专职负责保证文档的正确组织和发布,以及帮助工程师改进技术文档的质量。
分享题目:成都网站建设制作时间不够怎么办
标题来源:https://www.cdcxhl.com/news29/313179.html
成都网站建设公司_创新互联,为您提供网站策划、自适应网站、网站设计、虚拟主机、网站排名、外贸建站
声明:本网站发布的内容(图片、视频和文字)以用户投稿、用户转载内容为主,如果涉及侵权请尽快告知,我们将会在第一时间删除。文章观点不代表本网站立场,如需处理请联系客服。电话:028-86922220;邮箱:631063699@qq.com。内容未经允许不得转载,或转载时需注明来源: 创新互联
猜你还喜欢下面的内容