在上一篇“需求写作感受-面对文档应该有怎样的心态 ”中简单的写了如何面对文档,用什么心态来写文档。这里我们在继续讨论怎么把文档的需求写的更到位一些,我这里说的到位不是说全部到位,而是对需求的描述上,至于文档整体到位会在以后的文档和大家一些讨论。
首先要理解需求,那么怎么理解需求,更重要的关节莫过于沟通,很多写文档的工作者大多是从程序员上升到文档制作,比较容易犯错的就是:来一个需求立马就能在脑子反映出具体情形,或者是下意识的就去思考怎么实现等等,这个都不太可取。需求就是要知道客户需要达到的要求,那么怎么知道客户的需要什么呢?那就去问,具体怎么问,我们再在其他文章讨论,通过问,我们会知道客户需要什么,或者是客户的意思是什么,我们通过专业知识帮助他们整理一下,可以以客户的 角度去引导但不要加入自己的角度思维,否则可能会误导或者无意增加没必要的项目成本。
通过问知道客户需要做什么样的东西后,就需要考虑怎么用文档实现。每个人都有自己的文档框架思路,在正确的心态下可以将所知道的信息全部写进去,初步不需要考虑格式等展示细节。在把脑海里的信息展现出来后就会發現其中还有一些规律或者是遗漏,甚至是自己都搞的前后矛盾的细节,这些问题来源有两个:一个是客户本身对自己要做的东西不清晰,只知道自己要什么,但说不清楚自己要的细节;再一个就是自己对客户给的信息理解有误。基于上面的两个问题解决办法可以以这么一个方式来做:先完整的考虑一下整体,在考虑冗余的文字,然后再看前后矛盾的地方何原因。这些工作了之后就看自己能否再整理一个能符合正常逻辑的文字信息。如果可以就可以与客户再次沟通确认,如果仍有问题那么就在和客户沟通上进行针对性的问题解决。
通过这样的整理思考,来做有准备的沟通,一方面客户也没那么多的时间和你拉锯,再就是有些问题通过自己的思考就可以解决,这样会让客户更高兴,否则他会认为你没有很好的去思考他们的需求,而对你的实力或者做事态度大打折扣,整个过程千万要记住“您不是程序员”,唯独这样你的需求才能更准确,你的理解才能基本符合客户的需要。
这些是最近工作的一些体会如果有什么不合适或者不对的地方希望大家提出来一起学习进步,谢谢!
分享到:
相关推荐
【软件项目需求文档】是软件开发过程中的关键文档,它为整个项目提供了明确的方向和指导。以下是关于如何撰写有效的项目需求文档以及其中涉及的...因此,每个参与者都应理解和遵循需求文档的规范,确保项目的顺利进行。
产品描述应简洁明了地概括软件的核心功能和目的,例如,一个在线购物平台的主要目标是为用户提供便捷的购物体验。 2.2 产品功能 产品功能部分详细列出了软件需要实现的各项具体功能。每个功能都应描述得足够详细,...
总的来说,“程序员项目开发文档范例”涉及了从项目启动到维护的全过程,每个环节都有相应的文档支持,以确保项目的顺利进行和高效协作。程序员在实际工作中应熟练掌握这些文档的编写,以提升项目质量和团队合作水平...
在软件开发过程中,一个详尽且清晰的软件需求文档是至关重要的。它为项目团队提供了指导,确保所有相关人员对最终产品的期望保持一致。本压缩包包含了一系列与创建专业软件需求文档相关的资源,适用于软件开发者使用...
在撰写需求文档的过程中,使用markdown语言是一个不错的选择。Markdown是一种轻量级标记语言,它能够通过简单的标记语法生成格式化的文本,具有很强的可读性和易编辑性。对于开发人员而言,markdown格式的文档能提供...
Spring还包含了一个强大的MVC(Model-View-Controller)框架,用于构建Web应用程序,支持RESTful服务和WebSocket等现代技术。此外,Spring Boot简化了Spring应用程序的启动和配置,而Spring Data则提供了与各种...
其次,注重细节和准确性是写好需求文档的关键。文档的表述应当清晰,避免模棱两可的表述导致误解。这包括对功能的详尽描述,如“高亮显示”应具体说明何时、如何以及为何使用。每个功能点都应精确无误,确保所有相关...
需求文档通常包括多个方面,对于学习成为程序员的人来说,理解和掌握其内容至关重要。以下将深入探讨需求文档的主要部分及其重要性。 1. **需求概述**:这是文档的开头部分,简要介绍项目的目标、背景和预期结果。...
综上所述,程序员帮助文档仓库不仅是一个简单的文档集合,更是提高工作效率、促进技能成长的重要工具。通过合理利用CHM等格式的文档资源,结合有效的管理方法和个人实践经验,可以极大地提升个人和团队的技术水平。
总之,《程序员手册 v22文档》提供了一个全面的视角,覆盖了从基础知识到高级应用的各个方面,旨在帮助程序员更好地理解、使用和扩展CL2005Ocx控件。通过这份文档的指导,程序员不仅能够掌握控件的使用,还能加深对...
标题和描述中提到的“程序员受益终身的文档”聚焦于程序员个人品质的培养与提升,强调了在职业生涯中,除了专业技能(硬实力)外,软实力的重要性也不容忽视。文章通过具体案例和分析,深入探讨了程序员在成长过程中...
成为优秀的程序员不仅在于编写高质量的代码,更重要的是养成一系列有益的习惯,这些习惯能够提升个人技能,促进团队协作,以及保持对技术的敏锐度。以下是对标题和描述中提到的十个程序员习惯的详细解释: 1. **...
文档工程师是软件开发中的一个重要角色,是软件公司中不可或缺的一部分。他们负责内部软件文档、用户手册编写及演示版本的制作,同时也负责软件开发过程中的文档控制与规范。文档工程师的职责包括收集/提出文档需求...
"杀死一个程序员只需要改三次需求" 这个程序员圈内的调侃,揭示了一个深刻的现实:频繁的需求变动会给程序员带来巨大的困扰。下面将详细探讨这个话题。 首先,需求的变动源于对产品的持续优化和用户体验的提升。在...
2. **编程语言**:根据文件名"**xiao-bai-zuo-bi-she-master**"推测,可能包含的是一个初级程序员的毕业设计项目,可能涵盖了多种编程语言,如Java、Python、C++或JavaScript等。掌握至少一种编程语言,理解其语法...
本文将深入探讨润乾报表的程序员开发文档、用户手册以及用户帮助文档中的核心知识点,以便于开发者和使用者更好地理解和利用该工具。 1. **报表设计**:润乾报表支持多种报表类型,包括表格报表、图表报表、自由...
程序员应该养成撰写清晰、准确的技术文档的习惯,这包括但不限于需求文档、设计文档、代码注释等。文档不仅可以帮助团队成员更好地理解项目的结构和功能,还能在后期的维护、扩展和升级过程中发挥重要作用。缺乏文档...
### 一个程序员的工具箱:全面解析 #### 引言 在信息技术(IT)领域,特别是对于程序员来说,拥有一套高效、实用的工具是至关重要的。这些工具不仅能提高工作效率,还能帮助解决各种技术难题。本文将详细介绍《一个...
同时,文档也提到了一个有趣的现象,即随着时间的推移,认为程序员年龄上限的门槛在上升,这可能与软件行业的成熟以及对经验丰富程序员的需求增加有关。 其次,在学习与实践方面,文档强调了编程的基本功,包括面向...
此外,加入相关的技术社区也是一个不错的选择,在那里可以与其他开发者交流经验,共同进步。 #### 3. 不断优化代码质量 编写高质量的代码是每个程序员的基本功。这不仅包括遵循良好的编程规范(如命名约定、注释...