系统管理自测32问之9:有关设计文档

译文
运维 系统运维
所谓设计文档是一种用于记录提出的新点子或者描述当前状况的标准化格式。创建一套通用的模板。章节的标题可能包括:状况概念、预期目标、无目标状态、背景介绍、现有方案、备选思路、安全机制、灾难恢复以及成本控制等。在这种格式的指导下,大家可以轻松写出一份长达20页的网络结构调整计划。

【51CTO精选译文】本文是《Limoncelli的测试:有助于提高系统管理员团队工作效率的32个问题》当中的第9题:你的团队撰写“设计文档”吗?

所谓设计文档是一种用于记录提出的新点子或者描述当前状况标准化格式

创建一套通用的模板。章节的标题可能包括:状况概念、预期目标、无目标状态、背景介绍、现有方案、备选思路、安全机制、灾难恢复以及成本控制等。

在这种格式的指导下,大家可以轻松写出一份长达20页的网络结构调整计划。这份报告可以用五页阐述内置原型,使得团队成员能够理解并提出反馈意见;再以五页叙述具体的部署流程;另用一页作为备忘录,将计划中文件服务器的目录树所要使用的名称记录在案。有了这份文档,整套系统在建立并投入使用之后就具备了足够团队成员们参阅的详细说明。啊哈,这简直就是一份指导团队将你脑中想法变为现实的烹饪指南。

重点在于,你的团队必须提前准备好一套交流所必需的机制,这样就能在日常的沟通乃至闲聊中准确地传达彼此的构想。这种机制在保障成员互相理解实施方式及决策原因方面将发挥出不可替代的重要作用。

无论大家想要的是严肃的建设性意见,还是“如果我的设想与大家手头的现有工作间存在冲突,记得提醒我”这样较为松散的要求,标准化格式总能帮上大忙。

凭一人之力设计出的文档总会设置过多或是过少的章节标签,也就是说有些人觉得无话可说、另一些人却找不到合适的表达区块。标准化模板会让这些问题迎刃而解,同时也可以避免“言之无物”这类效率低下的现象。

 

【51CTO.com译文,转载请注明原文作译者和出处。】

原文:http://everythingsysadmin.com/the-test.html

Limoncelli的测试:有助于提高系统管理员团队工作效率的32个问题:

【编辑推荐】

  1. 《领域驱动设计:软件核心复杂性应对之道》之书面设计文档
  2. 系统管理员应该怎样高效的书写文档

 

责任编辑:yangsai 来源: 51CTO.com
相关推荐

2011-09-30 09:31:22

2011-09-29 09:41:24

系统管理项目管理系统

2011-09-30 10:36:07

系统管理测试

2011-09-30 09:50:55

系统管理服务监控

2011-09-29 10:49:39

系统管理Bug跟踪系统

2011-09-29 11:20:04

系统管理故障

2011-09-29 10:39:29

2011-10-20 15:32:07

系统管理访问管理

2011-09-29 10:28:07

系统管理维基

2011-09-29 10:01:08

系统管理策略

2011-09-29 10:54:11

系统管理优先级

2011-09-29 10:35:35

2011-09-29 10:13:13

系统管理指标量化

2011-09-30 10:12:58

2011-10-19 10:22:17

2011-10-20 14:25:24

系统管理账户管理

2011-10-19 11:01:30

系统管理灾难恢复

2011-10-19 11:17:39

系统管理电源控制

2011-09-30 09:54:31

系统管理呼叫轮换

2011-10-09 13:55:40

点赞
收藏

51CTO技术栈公众号