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

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

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

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

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

大学科系,需要哪些文档

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

软件项目的文档

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

为什么要有正式的文档

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

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

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

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

目录
相关文章
|
存储 算法 搜索推荐
标准模版库 知识点总结 C++程序设计与算法笔记总结(八) 北京大学 郭炜(下)
标准模版库 知识点总结 C++程序设计与算法笔记总结(八) 北京大学 郭炜(下)
74 0
|
存储 算法 C++
标准模版库 知识点总结 C++程序设计与算法笔记总结(八) 北京大学 郭炜(上)
标准模版库 知识点总结 C++程序设计与算法笔记总结(八) 北京大学 郭炜(上)
57 0
|
8月前
|
存储 人工智能 安全
面向企业的 ChatGPT 究极手册:第七章到第八章
面向企业的 ChatGPT 究极手册:第七章到第八章
157 0
面向企业的 ChatGPT 究极手册:第七章到第八章
|
8月前
|
机器学习/深度学习 物联网 定位技术
保研夏令营、考研复试、出国时个人陈述模板与撰写注意事项
保研夏令营、考研复试、出国时个人陈述模板与撰写注意事项
112 1
|
8月前
|
机器学习/深度学习 人工智能 安全
面向企业的 ChatGPT 究极手册:第九章到附录 A
面向企业的 ChatGPT 究极手册:第九章到附录 A
122 0
|
8月前
|
算法 芯片
嵌入式工程师如何快速的阅读datasheet的方法
嵌入式工程师如何快速的阅读datasheet的方法
167 0
|
程序员 测试技术 API
程序员不撰写代码注释和文档的十大理由
在软件开发的世界中,撰写代码注释和文档通常被认为是一项重要的工作,它可以帮助其他开发者理解你的代码,更容易地维护和扩展它。然而,在实际操作中,很多程序员却选择不写注释或文档。以下列出了程序员们在实践中经常提到的十大理由,这些理由不仅揭示了他们对于撰写文档和注释的观点,也反映出软件开发行业中一些深层次的问题。
167 1
程序员不撰写代码注释和文档的十大理由
|
NoSQL 前端开发 数据库
架构内容 节选自《闻缺陷则喜》(此书可免费下载)
架构内容 节选自《闻缺陷则喜》(此书可免费下载)
|
存储 运维 算法
软件工程——文档篇
何为软件工程?就是客户和开发人员提前定好相关需求,并形成文字材料,开发人员通过这个需求来开发软件,为了软件能够更适用,并进行相关的维护测试等方面的一个过程。简单来说就是开发人员通过需求来执行需求的这么一个过程。文档在其中就起到了不可言喻的重要作用了!!它为不同的群体提供了交流,提供了“参考”
|
程序员 数据库
【鸟瞰】软件工程文档
【鸟瞰】软件工程文档