《人月神话》(P10)必须有文档

简介: 每个项目中必然存在着一些书面工作,少数文档是整个项目的枢纽工作,整个项目的管理工作都围绕着它们运转。如果没有人维护这些文档,项目会处于无休止的混乱状态中。

每个项目中必然存在着一些书面工作,少数文档是整个项目的枢纽工作,整个项目的管理工作都围绕着它们运转。如果没有人维护这些文档,项目会处于无休止的混乱状态中。

制造一台机器,哪些是关键文档

1 目标
2 手册
3 进度
4 预算
5 组织机构
6 空间分配
7 机器本身的报价、预测和价格

大学科系,需要哪些文档

1 目标
2 课程描述
3 学位要求
4 研究报告
5 课程表
6 预算
7 教室分配
9 教师和研究生助手分配

软件项目的文档

1 目标:定义待完成目标,迫切需要的资源、约束和优先级
2 内容:以建议书开始,以用户手册和内部文档结束
3 时间进度
4 资金预算
5 工作空间分配
6 人员组织分配

为什么要有正式的文档

  • 书写过程中需要进行上百次的细小决定,能够让人们从令人迷惑的现象中得到清晰确定的策略。只有记录下来,分歧和矛盾才会突出。
  • 项目经理的职责是沟通而不是决定,文档能够极大的减轻沟通负担,使得计划和决策能够使在整个团队范围得到交流。
  • 回顾文档能够清楚项目所处的状态,以及哪些需要重点进行跟进和调整。

项目经理的任务是制定计划,并实现计划。但是只有书面的计划是精确和可以沟通的。计划中包括了时间、人员、内容和资金。这些少量的关键文档封装了项目经理的大量工作。如果一开始就能认识到它们的普遍性和重要性,那么就可以将文档利用起来,而不会让它成为令人厌烦的繁重任务。通过遵循文档开展工作,项目经理能更清晰和快速的设定自己的方向。

以上内容就是《人月神话》第十章——提纲挈领的全部内容

本章中作者提到了文档在整个项目中的重要性,如果缺失了文档,将会失去沟通、方向,并使得项目陷入混乱之中。文档是项目经理的职责,也是最主要的工具。文档一定是要有人维护的,可是实际的项目开发中却经常会因为文档的繁琐而放弃编写,或者项目组中人员比较少所以没有足够的人手去做这件事。
我觉得这是很危险的,项目一旦失去了监督、反馈、目标、沟通将会变得一团糟。
即使再小的团队,再小的项目,再紧张的时间,哪怕只是一个功能,文档也是必须的。

目录
相关文章
|
6月前
|
存储 监控 项目管理
PMBOK泛读(开篇) - 术语表(二)
PMBOK泛读(开篇) - 术语表(二)
18 0
|
5月前
|
算法 芯片
嵌入式工程师如何快速的阅读datasheet的方法
嵌入式工程师如何快速的阅读datasheet的方法
62 0
|
6月前
|
监控 项目管理
PMBOK泛读(开篇) - 术语表(四)
PMBOK泛读(开篇) - 术语表(四)
17 0
|
6月前
|
存储 监控 数据可视化
PMBOK泛读(开篇) - 术语表(三)
PMBOK泛读(开篇) - 术语表(三)
14 0
|
6月前
|
数据采集 存储 自然语言处理
PMBOK泛读(开篇) - 术语表(一)
PMBOK泛读(开篇) - 术语表
25 0
|
10月前
|
程序员 测试技术 API
程序员不撰写代码注释和文档的十大理由
在软件开发的世界中,撰写代码注释和文档通常被认为是一项重要的工作,它可以帮助其他开发者理解你的代码,更容易地维护和扩展它。然而,在实际操作中,很多程序员却选择不写注释或文档。以下列出了程序员们在实践中经常提到的十大理由,这些理由不仅揭示了他们对于撰写文档和注释的观点,也反映出软件开发行业中一些深层次的问题。
109 1
程序员不撰写代码注释和文档的十大理由
|
存储 Java 程序员
如何写好技术文档——来自Google十多年的文档经验
如何写好技术文档——来自Google十多年的文档经验
449 2
如何写好技术文档——来自Google十多年的文档经验
|
JavaScript 搜索推荐 前端开发
软件工程师文档写作最佳实践
软件工程师文档写作最佳实践
140 1
软件工程师文档写作最佳实践
|
SQL JSON 监控
一个文档引发的惨案
这里只是介绍一下思路,真实项目里面并不是完全这么做的。
一个文档引发的惨案
网友提问:当我要使用一个陌生的标准BAPI,我可以去哪里找到比较详尽的文档指导一类的资料
网友提问:当我要使用一个陌生的标准BAPI,我可以去哪里找到比较详尽的文档指导一类的资料
网友提问:当我要使用一个陌生的标准BAPI,我可以去哪里找到比较详尽的文档指导一类的资料