`
wangyun71
  • 浏览: 9935 次
  • 性别: Icon_minigender_1
  • 来自: 西安
社区版块
存档分类
最新评论

一个程序员如何写需求文档

阅读更多

       在上一篇“需求写作感受-面对文档应该有怎样的心态 ”中简单的写了如何面对文档,用什么心态来写文档。这里我们在继续讨论怎么把文档的需求写的更到位一些,我这里说的到位不是说全部到位,而是对需求的描述上,至于文档整体到位会在以后的文档和大家一些讨论。
       首先要理解需求,那么怎么理解需求,更重要的关节莫过于沟通,很多写文档的工作者大多是从程序员上升到文档制作,比较容易犯错的就是:来一个需求立马就能在脑子反映出具体情形,或者是下意识的就去思考怎么实现等等,这个都不太可取。需求就是要知道客户需要达到的要求,那么怎么知道客户的需要什么呢?那就去问,具体怎么问,我们再在其他文章讨论,通过问,我们会知道客户需要什么,或者是客户的意思是什么,我们通过专业知识帮助他们整理一下,可以以客户的 角度去引导但不要加入自己的角度思维,否则可能会误导或者无意增加没必要的项目成本。
       通过问知道客户需要做什么样的东西后,就需要考虑怎么用文档实现。每个人都有自己的文档框架思路,在正确的心态下可以将所知道的信息全部写进去,初步不需要考虑格式等展示细节。在把脑海里的信息展现出来后就会發現其中还有一些规律或者是遗漏,甚至是自己都搞的前后矛盾的细节,这些问题来源有两个:一个是客户本身对自己要做的东西不清晰,只知道自己要什么,但说不清楚自己要的细节;再一个就是自己对客户给的信息理解有误。基于上面的两个问题解决办法可以以这么一个方式来做:先完整的考虑一下整体,在考虑冗余的文字,然后再看前后矛盾的地方何原因。这些工作了之后就看自己能否再整理一个能符合正常逻辑的文字信息。如果可以就可以与客户再次沟通确认,如果仍有问题那么就在和客户沟通上进行针对性的问题解决。
       通过这样的整理思考,来做有准备的沟通,一方面客户也没那么多的时间和你拉锯,再就是有些问题通过自己的思考就可以解决,这样会让客户更高兴,否则他会认为你没有很好的去思考他们的需求,而对你的实力或者做事态度大打折扣,整个过程千万要记住“您不是程序员”,唯独这样你的需求才能更准确,你的理解才能基本符合客户的需要。
这些是最近工作的一些体会如果有什么不合适或者不对的地方希望大家提出来一起学习进步,谢谢!

 

1
1
分享到:
评论

相关推荐

    程序员软件项目需求文档

    【软件项目需求文档】是软件开发过程中的关键文档,它为整个项目提供了明确的方向和指导。以下是关于如何撰写有效的项目需求文档以及其中涉及的...因此,每个参与者都应理解和遵循需求文档的规范,确保项目的顺利进行。

    程序开发功能需求文档模板.docx

    产品描述应简洁明了地概括软件的核心功能和目的,例如,一个在线购物平台的主要目标是为用户提供便捷的购物体验。 2.2 产品功能 产品功能部分详细列出了软件需要实现的各项具体功能。每个功能都应描述得足够详细,...

    程序员项目开发文档范例

    总的来说,“程序员项目开发文档范例”涉及了从项目启动到维护的全过程,每个环节都有相应的文档支持,以确保项目的顺利进行和高效协作。程序员在实际工作中应熟练掌握这些文档的编写,以提升项目质量和团队合作水平...

    如何写一份程序员爱看的需求文档?.docx

    如何写一份程序员爱看的需求文档? 在软件开发过程中,需求文档(PRD)是产品经理和开发人员之间的桥梁,然而,一份不良的需求文档将会导致开发人员的困惑和反复确认,浪费大量时间和资源。那么,如何写一份用户...

    软件需求文档模板(软件开发者专用)

    在软件开发过程中,一个详尽且清晰的软件需求文档是至关重要的。它为项目团队提供了指导,确保所有相关人员对最终产品的期望保持一致。本压缩包包含了一系列与创建专业软件需求文档相关的资源,适用于软件开发者使用...

    java程序员必备帮助文档大全

    Spring还包含了一个强大的MVC(Model-View-Controller)框架,用于构建Web应用程序,支持RESTful服务和WebSocket等现代技术。此外,Spring Boot简化了Spring应用程序的启动和配置,而Spring Data则提供了与各种...

    应该如何写好需求文档

    其次,注重细节和准确性是写好需求文档的关键。文档的表述应当清晰,避免模棱两可的表述导致误解。这包括对功能的详尽描述,如“高亮显示”应具体说明何时、如何以及为何使用。每个功能点都应精确无误,确保所有相关...

    学程序员所需要的(需求文档)

    需求文档通常包括多个方面,对于学习成为程序员的人来说,理解和掌握其内容至关重要。以下将深入探讨需求文档的主要部分及其重要性。 1. **需求概述**:这是文档的开头部分,简要介绍项目的目标、背景和预期结果。...

    程序员帮助文档仓库(chm)

    综上所述,程序员帮助文档仓库不仅是一个简单的文档集合,更是提高工作效率、促进技能成长的重要工具。通过合理利用CHM等格式的文档资源,结合有效的管理方法和个人实践经验,可以极大地提升个人和团队的技术水平。

    程序员手册 v22文档

    《程序员手册 v22文档》是一份非常实用的资源,主要针对程序员,旨在提供有关CL2005Ocx控件的详细使用指南。这份文档适用于CL2005Ocx 1.0.2.0及更高版本,且根据2008年11月的更新,内容可能涵盖了该时间段的最新技术...

    一个优秀的程序员的十个习惯

    成为优秀的程序员不仅在于编写高质量的代码,更重要的是养成一系列有益的习惯,这些习惯能够提升个人技能,促进团队协作,以及保持对技术的敏锐度。以下是对标题和描述中提到的十个程序员习惯的详细解释: 1. **...

    程序员(程序员受益终身的文档)

    标题和描述中提到的“程序员受益终身的文档”聚焦于程序员个人品质的培养与提升,强调了在职业生涯中,除了专业技能(硬实力)外,软实力的重要性也不容忽视。文章通过具体案例和分析,深入探讨了程序员在成长过程中...

    mac 文档查询神器 dash 程序员必备

    2. **离线访问**:一旦文档被下载,Dash 可以在没有网络的情况下依然提供查阅,这对于开发者来说是一个巨大的便利,特别是在编写代码时需要频繁查阅文档但又无法连接互联网的场景。 3. **自定义文档集**:除了内置...

    程序员-文档工程师.pptx

    文档工程师是软件开发中的一个重要角色,是软件公司中不可或缺的一部分。他们负责内部软件文档、用户手册编写及演示版本的制作,同时也负责软件开发过程中的文档控制与规范。文档工程师的职责包括收集/提出文档需求...

    杀死一个程序员只需要改三次需求_黄寅佐1

    "杀死一个程序员只需要改三次需求" 这个程序员圈内的调侃,揭示了一个深刻的现实:频繁的需求变动会给程序员带来巨大的困扰。下面将详细探讨这个话题。 首先,需求的变动源于对产品的持续优化和用户体验的提升。在...

    润乾报表程序员开发文档、用户手册、用户帮助文档

    本文将深入探讨润乾报表的程序员开发文档、用户手册以及用户帮助文档中的核心知识点,以便于开发者和使用者更好地理解和利用该工具。 1. **报表设计**:润乾报表支持多种报表类型,包括表格报表、图表报表、自由...

    作一个真正合格程序员的七种素质

    程序员应该养成撰写清晰、准确的技术文档的习惯,这包括但不限于需求文档、设计文档、代码注释等。文档不仅可以帮助团队成员更好地理解项目的结构和功能,还能在后期的维护、扩展和升级过程中发挥重要作用。缺乏文档...

    一个程序员的工具箱

    ### 一个程序员的工具箱:全面解析 #### 引言 在信息技术(IT)领域,特别是对于程序员来说,拥有一套高效、实用的工具是至关重要的。这些工具不仅能提高工作效率,还能帮助解决各种技术难题。本文将详细介绍《一个...

    程序员之路探究

    同时,文档也提到了一个有趣的现象,即随着时间的推移,认为程序员年龄上限的门槛在上升,这可能与软件行业的成熟以及对经验丰富程序员的需求增加有关。 其次,在学习与实践方面,文档强调了编程的基本功,包括面向...

    对程序员的忠告 txt文档

    此外,加入相关的技术社区也是一个不错的选择,在那里可以与其他开发者交流经验,共同进步。 #### 3. 不断优化代码质量 编写高质量的代码是每个程序员的基本功。这不仅包括遵循良好的编程规范(如命名约定、注释...

Global site tag (gtag.js) - Google Analytics