文档机制(5W2H)

68 阅读2分钟

WHAT - 做什么事情

  1. 梳理文档结构
  2. 文档能力培训
  3. 完善关键系统文档
  4. 建立文档机制

WHY - 为什么做这个事情

  • 个人层面
    • 好的文档能力,可以帮助开发者理清思路,提升代码质量。
  • 项目层面
    • 从项目立项开始,制定目标,拆解任务,依赖识别,风险控制,结果验证等一系列事项,都需要有文档落地,确保每一环节能跟踪和检验
    • 减少理解偏差,提升沟通效率
  • 团队层面
    • 经验有沉淀,可传承

WHEN - 什么时候做

文档应当涉及到每一个环节,事前有计划、事中有跟踪、事后有总结。

  • 架构设计输出、项目计划拆解 -- 前置
  • 规范流程 -- 前置经验,过程中完善
  • 学习记录、实践总结 -- 后置

WHO - 哪些人参与

须全员参与。 前期由文档能力强的带领其他同学推进,最终都能具备好的文档能力

HOW - 具体如何来实施

按照 PDCA方法论参考 的方式推进实施,经过多次循环,最终让团队的文档能力达到较好的水准。

Plan - 计划阶段

  • 目标
    • 专项文档全覆盖
    • 跑顺版本迭代中的技术文档流程
    • 补充现有关键系统的文档
    • 建立文档机制
  • 计划
    • 每个周期限定 1 个月

Do - 设计和实施阶段

  • 明确责任人,按计划进行实施,期间需要安排文档能力培训与指导。

Check - 检查阶段

  • 每周进展同步,文档质量检查

Action - 处理阶段

  • 根据检查结果,把成功的经验总结出来,指定相应的标准;把没有解决或新出现的问题,转入下个PDCA循环去解决。