`
残缺的完美
  • 浏览: 42782 次
  • 性别: Icon_minigender_1
  • 来自: 上海
社区版块
存档分类
最新评论

文档与工程的故事

阅读更多

从前有个工匠,依靠自己的不错得手艺,闻名乡里,也因此接了不少的小工程,赚了不少钱。

     但是随着名声得增长,工程也越做越大,虽然他得技术了的,但是还是问题不断。例如:一次,雇主觉得他技术了得不用多说什么,所以只给了他一个比较详细的设计图就让他开始做工程了。这个工匠得技术果然了得,如神一般的,20天之内做成了50米高得水塔。然后他把主雇叫来就准备收钱了,但是主雇看到了却苦笑不得:原来图上得数字都是横向得,他得本意是要打一口井,没想到他把图看反了………………之后由于工程越来越大,他常常不是忘记主雇的一些要求,就是做了一些画蛇添足得事情,最过分得莫过于蛮横得雇主不断的提出之前没有约定过得要求,他的生意没况遇下。后来他不得不把雇主得每个要求详细的写到一个文档中,并写入契约。虽然在开工之前往往要费很多时间来做秀才做的事,但是由于这个文档,他减少了很多后顾之忧,他得生意又慢慢好了起来。后来他又规范了这个文档,使得他能够很快记住和回想起主雇得想要得东西并且能够成为法律依据。他还给这个文档起了一个名字,叫工程需求规格说明书,但是其他得工匠对之嗤之以鼻,觉得只要技术硬,心细,就没问题了,他们更愿意花些功夫搞搞发明,练习技术。

     后来他所承包的工程规模更近一步,他组建了一个工匠队。虽然他们每个人的技术都不错,但是他们还是常常疏忽,出现了一些莫名其妙得问题:他们做了一个东西却没有完成主雇得功能;他们做的部件之间无法合作;他们做的东西时不时功能重复;工匠A做的东西其他人都不知道这个是干什么的,以至于A不在的时候工程无法继续。一段时间以后,他觉得他又遇到了瓶颈,他不断寻找方法,训练他得工匠队,但是往往杯水车薪。这时他又想起了他遇到上一个瓶颈时得情况,于是他们在做下一个工程之前做完需求之后开始写写画画,不久他们做成了一份文档,上面规定了每个大部件做完成得功能、所用的材料及与其它部件如何一同完成一个大得功能。虽然第一次他的队员们对写写画画得工作怨声载道,觉得这并不是一个工匠所应为得事情,但是时间一长,那些奇怪得问题发生率明显下降,开始的写画工作使他们得错误明显减少,他们也慢慢得开始主动得做这个文档了。他们把这个文档命名为工程概要设计说明书。而其他得工匠队却一直不明白为什么他们得错误率如此之低。

     后来他们越做越大,开了一个工匠团,大量承接工程。但是在面对超大规模得工程时,他们又遇到了困难:部件由不同工匠负责,虽然他们规定了功能,材料等问题,但是他们却不知道其他部件会对自己得部件造成多大的影响,造成多大的磨损、完成自己的部件最多能用多少材料、在自己的部件上会发生什么事情,如何安排自己部件得内部结构使得自己得部件发挥最大作用等等。这回这个工匠,自然而然得就由开始规定大家在工程之间加写一个文档,他详细得描述了每个部件,每个工匠也欣然接受,问题迎刃而解。他管这个文档叫做详细设计说明书。

     后来他们为了更严格与全面的计划测试与方便用户使用,又发明了测试工程测试文档、用户使用说明书。这些文档,使得他们的工作效率与质量节节提高:他们在工程期间要做的只是按照文档内容按部就班进行,这个工匠团从此全国闻名………………

     后来他们写文档的时间甚至超过了做工程的时间。但是一些还停留在承接小项目的工匠却总是不明白,为什么在那个工匠里的工匠会变的像个秀才一样总是写写画画的,直到他们第一次尝试严格得使用那个工匠发明的文档………………

 

分享到:
评论

相关推荐

    软件工程项目开发文档范例

    3. **需求分析**:需求分析文档包括《需求规格说明书》,详细列出软件的功能和非功能需求,是开发团队与客户之间的重要沟通工具。此外,可能还包括《用户故事》或《用例图》来进一步描绘用户交互。 4. **软件设计**...

    软件工程国际标准说明文档

    《软件工程国际标准说明文档》是一份详尽的资料,旨在为软件开发团队提供一套完整的文档编写规范。软件工程文档是软件开发过程中不可或缺的一部分,它不仅记录了项目的各个阶段,也确保了团队间的有效沟通和项目的...

    软件工程各个阶段的文档

    在软件工程领域,文档是项目成功的关键因素之一。它们不仅记录了项目的各个阶段,还确保了团队间的有效沟通,降低了理解和维护的成本。本资源提供的"国家标准-软件开发规范"涵盖了软件开发过程中的主要文档,这些...

    国家软件工程文档模版

    《国家软件工程文档模版》是一套标准化的文档框架,旨在规范软件开发过程中的文档编制,提高工作效率,确保项目的质量与进度。这套模版涵盖了软件工程的各个阶段,包括需求分析、系统设计、编码实现、测试验证以及...

    软件工程所有 文档模板

    3. 用户故事文档:通过描述用户如何与产品交互,来表达功能需求,便于开发人员理解用户视角。 4. 系统架构设计:描述系统组件、接口、数据流等,为软件架构提供蓝图。 5. 数据库设计文档:详细说明数据库结构,...

    软件工程开发文档模板(全)

    "软件工程开发文档模板(全)" 提供了从项目初期到后期维护所需的各种文档模板,涵盖了软件开发的全过程。以下将详细介绍这些模板的重要性和主要内容。 1. 可行性研究报告:这份报告是项目启动前的初步评估,主要...

    软件工程文档实例书写步骤

    下面将详细讲解"软件工程文档实例书写步骤"中的各个阶段,以及每个阶段对应的文档内容。 1. **需求分析**: 需求分析文档是软件开发的第一步,它明确了系统的目标、功能和性能需求。这个阶段的文档通常包括《需求...

    软件工程项目管理文档

    "软件工程项目管理文档"是一个宝贵的资源,为初学者提供了全面的学习材料和实践指导。以下是这些文档可能涵盖的关键知识点: 1. **项目启动**:这是项目管理的第一步,包括定义项目目标、确定项目范围、制定初步...

    工程文档模板

    在IT行业中,工程文档是项目管理的关键组成部分,它确保了团队成员之间清晰的沟通和项目的顺利执行。"工程文档模板"是一系列预先定义的格式,用于编写不同阶段所需的文档,如需求分析、设计、测试和评估等。这些模板...

    软件工程文档需求分析

    需求文档通常会包含业务流程图、用户故事和用例,以便更直观地描述需求。 二、需求分类与优先级排序 需求可以分为功能性需求和非功能性需求。功能性需求定义了软件应执行的具体操作,而非功能性需求涉及性能、安全...

    软件工程全部阶段的文档模板

    - 用户故事:用简明的语言描述用户如何与系统交互,帮助开发人员理解用户需求。 - 业务流程图:描绘业务操作的顺序,帮助设计人员理解系统流程。 2. 设计阶段: - 系统架构设计:定义系统的模块划分,组件间的...

    软件工程全套文档模板

    《软件工程全套文档模板》是一套全面覆盖软件开发过程各个阶段的规范性文件模板,旨在为软件开发团队提供标准化的指导,确保项目管理的高效、规范与质量保证。这套模板通常包括需求分析、设计、编码、测试以及维护等...

    完美的软件工程文档范例

    在软件工程领域,文档是项目成功的关键因素之一。一个完美的软件工程文档范例涵盖了从项目开始到结束的全过程,确保所有参与者对项目有清晰、一致的理解。以下将详细阐述各个部分的知识点: 1. **范围**: 这部分...

    现代软件工程文档模板

    "现代软件工程文档模板"集合了全面的文档模版,旨在为软件项目提供一套规范、详尽的参考框架。以下是这些文档模板涵盖的关键知识点: 1. **项目启动文档**:这是项目的起点,包括项目背景、目标、范围、预期成果...

    软件工程相关文档模板

    4. 用例图和用户故事:用例图是可视化表示用户与系统交互的方式,用户故事则以用户的角度描述功能需求。这些模板有助于理解用户需求,确保开发出符合用户期望的产品。 5. 测试计划和测试用例:测试文档定义了测试...

    软件工程项目文档模板

    在软件工程领域,项目文档是确保项目顺利进行的关键要素,它们记录了项目的各个方面,包括需求、设计、实现、测试和维护等。"软件工程项目文档模板" 提供了一套完整的框架,帮助开发者和团队遵循标准流程,提高工作...

    软件工程课程设计和软件开发过程中各种文档,软件工程全过程文档模版,软件开发文档模版

    本资源“软件工程课程设计和软件开发过程中各种文档”提供了一套完整的软件工程全过程文档模板,是学习和实践软件工程的重要参考资料。 一、软件开发文档概述 软件开发文档是软件生命周期中的重要组成部分,它包括...

    各种软件工程文档模板

    本资源包"各种软件工程文档模板"包含了软件工程不同阶段所需的关键文档,如产品需求规格说明书和模块设计报告等。下面将详细介绍这些文档的重要性和内容结构。 首先,产品需求规格说明书(PRS,Product ...

    软件工程-图书管理系统-各阶段文档

    同时,还会制作《用户故事》和《用例图》,以更直观地展示用户与系统的交互。 2. 设计阶段: 设计阶段包括概要设计和详细设计。《系统架构设计》文档描绘了系统的整体结构,包括模块划分、接口定义和数据库设计。...

Global site tag (gtag.js) - Google Analytics