写一种花150字
需求文档是产品经理和其他人对接的一个重要产品，然而由于文字描述的抽象，随着描述越精准，可读性不可避免地会变差，有些人会选择把抽象的逻辑转换成“更具体”的流程图。但是，流程图真的“更具体”了吗？有什么方式能更清晰地表达你的需求呢？本文作者对此进行了分析，希望能给你带来一些帮助。
需求文档是你和其他人对接的一个重要产品，它的核心竞争力是——可读性强。
如果你接手过一个其他产品负责的项目，你一定会关注文档的可读性，毕竟，要是写得难懂，那维护起来着实是一大麻烦。
这就跟程序员看开发文档一样，好的文档结构清晰，涉及概念时，会有实例说明，而且文档照顾了人们的阅读习惯（简单说，就是太长不看），读起来很舒服。
但如果你看到的文档描述起来是类似这样的呢？
报告的生成规则跟随方案内单元的开启规则，具体为：
每个方案内，每新开启一个单元且该单元内包含训练任务，对应一份报告。
例如，同一天内用户有两个方案各开启了一个新单元，且单元内包含训练任务，则当天生成两份训练报告；同一天内用户有一个方案开启了两个新单元，一个单元含训练任务，一个单元不包含训练任务（比如全是测评任务），则当天生成一份报告；同一天内用户有一个方案开启了两个新单元，且都包含训练任务，则当天生成两份报告。
会不会有一种要硬着头皮读下去的感觉。
主要是因为文字太长了，对进行信息分段处理造成了困难。而且，汉字本来就比较模糊，不适合描述复杂的逻辑。
再加上文字本身就是对事物的一层抽象，而我们用文字描述一种规则又是另一层抽象。而且随着描述得越精准，可读性不可避免地会变差。
所以人们说：一图胜千言。
那很自然，大家会选择把抽象的逻辑转换成“更具体”的流程图。
但问题是，流程图真的“更具体”了吗？
01 使用战术而不是天赋，来提高你的文档可读性
流程图面临许多问题，其中最重要的是，它不是研发常常看到的语言，这涉及到了一个转化成本。
首先定义一个问题，我们的文档是给谁看的？
主要是研发，次要是产品同事。那么研发看流程图方便吗？作为一个前研发来说，图大于一长串文字。但是，流程图弯弯绕绕，各种箭头指向，确实存在理解和转化的成本。
1. 解决方案是：给伪码说到头，研发是要用程序语言和电脑进行沟通的，你费力画成图，让研发理解图的意思，再从图转成代码，不如直接写给研发伪码，这样也省下了你一个个拖框、填文字的辛苦。
听到“伪码”，不用慌张，毕竟我们用的也就是一些条件判断而已。
比如，最开始给的例子，我们可以这么写：
if 第X天，用户在 a1 方案内：
开启了 1个单元 & 单元内训练任务数 >0：
生成1份报告
实例：
第X天，用户的a1、a2方案：
各开启了1个新单元 & 单元内训练任务数 >0：
生成 2 份报告
a1方案，新单元_生成1份报告
a2方案，新单元_生成1份报告
会不会清楚很多？
像上面那样，使用条件判断（if），and逻辑，把输入、输出及中间过程的约束条件，一个个列清楚，这样，无论谁来看，都可以很明白地get到你的意思。哪怕时间过了很久，你自己看也看着方便。
写的时候，可以想象自己在出数学题，把逻辑、可能用到的变量都梳理一遍，尽可能地做到“完全穷尽且互相独立”。
比如，如果天数是你的约束条件，那就可以写“if 第X天”，这样研发就能关注到X是一个变量。后面你自己想对天数做更进一步的处理，只需要再给X加上限制条件，比如 if X≥5，之类的，就可以了。
同时，要记住不仅是你会因为太长不看，其他人也是一样的懒，所以尽可能一句话写得短小一些，减少他人对信息的处理量。
当然，你也可以直接询问chatGPT，让它给你答案。
不过我感觉不太符合我的需求，过于研发化了，但这也是个思路，可以帮助我们进行优化，大家可以看情况进行处理。
02 授人以鱼，不如？
这样写文档，确实让研发在对需求时非常明确，让我们的沟通更加便捷。但我这么写的底层逻辑是什么呢？
下面部分会科普一些研发知识，慢慢来吧。
其实，我遵循的逻辑就是：
- 先写研发逻辑（Controller），“怎么运行”
- 再写数据结构或者具体例子（Model），“是个啥”
- 最后写视觉需求（View），“长啥样”
当然，写作顺序可以随你喜欢。这里的重点是，我用到了开发中一个经典模式：MVC。
1. 什么是MVC以下是一段什么是MVC的科普，嫌长可以直接跳过不看。
MVC是一种常用于软件开发的设计模式，它包括三个组件：Model（模型）、View（视图）和Controller（控制器）。
这三个组件分别负责应用程序的不同功能，协同工作以实现应用程序的有效管理和高效运行。
模型（Model）：负责处理应用程序的数据和业务逻辑。它表示应用程序中的数据结构、数据库的操作、数据的处理和计算等。模型不关心数据如何展示或者如何与用户进行交互，只负责处理数据的存取和处理逻辑的实现。
视图（View）：负责展示模型中的数据给用户。它负责应用程序的用户界面，包括用户界面的布局、样式、展示逻辑等。视图根据模型的数据来生成用户界面，但它不直接处理用户的输入或者修改数据。
控制器（Controller）：负责接收用户的输入，并根据输入来更新模型和视图。它负责用户输入的处理、业务逻辑的调度以及模型和视图之间的协调。控制器接收用户的输入后，更新模型的数据，并通知视图进行界面的更新。
2. 它有什么好处了解了MVC是什么，那使用它的好处也就呼之欲出了。
MVC的核心在于将产品进行了分离，分离成了：
- 模型，Model，即数据结构，也就是“是个啥”
- 控制器，Controller，即运行逻辑，也就是“怎么跑”
- 视图展现，View，也就是“长啥样”
这3个部分下面我们做更详细的解读。
试着把自己的需求切片，想像成：
1）逻辑部分，即文档中，常见的流程图&说明功能部分
它是MVC中的C，Controller，这部分我们一般会对接：后端同学。
写需求时，我们可以将逻辑&例子分开写，这样的好处是进行了解耦。说人话就是：逻辑和例子不会搅成一团浆糊，比较有节奏&之后自己删改会比较方便。
2）视图部分，即交互需求、UI需求部分
它是MVC中的V，View，对接的是：前端、UI同学。
有的项目可能会需要我们提出数据需求，那么就会有第3点：
3）数据部分，即数据需求，MVC中的M，Model。
数据需求或者说数据结构，你可以把它想象成我们需求中的一个个例子，有的例子里是几段文本，有的会带些数字。对接这部分时，掌握一些基础的数据结构对我们会有帮助。这部分内容挺多的，但对我们这次的主题没有影响，先挖个坑，之后再讲
总之，使用MVC模块就能够帮助我们拆分需求的运行逻辑、数据结构、视图展现这3个方面，而这3个方面就包含了软件开发的所有部分。所有之后提需求，可以试着用这种方式拆分自己的逻辑，特定需求对特定的人，会变得更加清楚。
作者：探索者，公众号：探索者的神庙
本文由 @探索者 原创发布于人人都是产品经理，未经许可，禁止转载
题图来自 Unsplash，基于CC0协议。
该文观点仅代表作者本人，人人都是产品经理平台仅提供信息存储空间服务。
","gnid":"9c33c73bc6700c8a8","img_data":[{"flag":2,"img":[{"desc":"","height":"420","title":"","url":"https://p0.ssl.img.360kuai.com/t01a57f4673031a57f9.jpg","width":"900"},{"desc":"","height":"736","title":"","url":"https://p0.ssl.img.360kuai.com/t013fa5d3d2a251acf4.jpg","width":"1065"},{"desc":"","height":"300","title":"","url":"https://p0.ssl.img.360kuai.com/t01b7c1c05e6017caf1.jpg","width":"627"}]}],"original":0,"pat":"qgc,art_src_3,fts0,sts0","powerby":"hbase","pub_time":1681785780000,"pure":"","rawurl":"http://zm.news.so.com/92e576ed3d531bc33e0218a726c62f04","redirect":0,"rptid":"9943be96174efa0b","rss_ext":[],"s":"t","src":"人人都是产品经理","tag":[{"clk":"ktechnology_1:数据结构","k":"数据结构","u":""}],"title":"不要再画流程图了，换一种方式写你的需求吧
晏吉径4662我爱你,一种花150字作文 -
糜阁壮15540283489 ______ 我喜欢的一种花作文150字 春天是百花的季节,朵朵花争芳斗艳,有粉红的桃花,金黄的迎春花,雪白的梨花,但我最喜欢樱花.朵朵樱花挂满枝头,一枝上就有十几朵花球球,连枝儿都压弯了.远远望去,就像一大片五颜六色的地毯,美极了.近看花是五角星形的,花心是下面白上面黄,像一小棵豆芽,风一吹来,花儿就向路人点头.它的颜色非常多,有白色,有粉色和红色等,看这棵像是挂满“银子”的发财树,另一棵像是扑过粉的小姑娘.樱花不止是让人观看,还有其它作用,比如说美容、泡茶等.樱花还可以做裙子,什么?做裙子?!没错,心灵手巧的人可以把一片一片的花瓣绣在裙子上呢!啊,樱花,你用生命换取了人类的幸福,我喜欢你!
晏吉径4662写一段一百五十字左右的话,来描述你喜欢的一种花 -
糜阁壮15540283489 ______ 猗猗秋兰色,布叶何葱青.爱此王者香,著花秀中庭＂.窗前兰,娴静的影子映照着稀疏的窗棂.为之舒服,为之倾醉.不爱雍容华贵牡丹,不爱妖艳妩媚的玫瑰,不爱花枝招展的郁金香.朱德总司令,一生爱兰,曾做诗颂兰:＂幽兰吐芳乔林下,仍自盘根众草旁.纵是无人见欣赏,依然得地自含芳.这个世界有多少种花,便也有了多少种女人,这个世界有一百株兰花,如兰女子却无一半.处事淡然,处事不惊,遇事不急躁,悠然若素,独有兰,遗世独立.
晏吉径4662花的文章150 - 字 -
糜阁壮15540283489 ______ 当冬天尚未走出这个季节的寒冷与麻木,在转身和回眸之间,一种温暖已经悄然地挂在枝头了.这个时候,迎春花以她特有的姿态和拥抱春天的胸怀早早地开放了.黄色的花蕾和花瓣在缺乏色彩的冬天静静地绽放出一种喜悦和风情.春天要来了,春...
晏吉径4662日记 写花的!150字 -
糜阁壮15540283489 ______[答案] 窗边,金黄色的花静静地开着,似乎是秋天遗留下的痕迹. 现在是盛夏的尾巴,再差一点点,再差一点点,就要看到树影安静栖息的模样. 走在街上,仍旧是燥热,空气里弥漫着忙碌和喧嚣. 是偶然看到路边的草地上绽放着一丛金黄色的花,刹那间世...
晏吉径4662描写一种花的形状,颜色,气味. -
糜阁壮15540283489 ______ 描写一种花的形状,颜色,气味. 例如, 百合花 ☆百合花的形状:植株的茎是圆柱形,无绒毛,多数是绿色.叶片的形状较多,披针形、椭圆形或条形,它的叶片没有柄或者有短柄.‖它的花比较大,花被片有6枚,有钟形也有喇叭形. ☆百合花的颜色:有白色、粉色、黄色、橙红、黑色、红色、粉红.... ☆百合花的气味:会散发迷人的香气 (百合花花语:它的花语是高雅、纯洁、顺利和百年好合,象征着纯洁美好的心灵.它还有祝福的含义,多出现在婚礼上面,寓意对新人的美好祝福.另外,它也是有很多其他品种的,花语也都不同,野百合的花语是永远幸福;玉米百合的花语是勇敢和执着的爱. .....(*˘︶˘*)...:*♡
晏吉径4662关于花的介绍 - 怎么写介绍1种花的说明文(300)写一种花,介绍这种花,说明文
糜阁壮15540283489 ______ 百合花也叫山丹,卷丹.它是单子叶百合科,百合属.百合花绝大多数分布在北温带,但是也可以当作盘栽欣赏,植株庭园或花坛.可能是因为百合花花期长,花色多,有...
晏吉径4662初中小作文随写一种自己喜爱的花150字左右 -
糜阁壮15540283489 ______ 每个人的心底都有一座象牙塔,那是父母呵护下的水晶天堂,那是由童真编织成的五彩梦境,它在我们每个人心底那方最柔软的地方,庇佑着我们那颗青涩的心.但某一天,一柄利剑会无情地将它打破,让我们褪去青涩,远离天真,抛开懵懂的年纪,走向成熟.正如蝴蝶破茧而出,就像凤凰遇火重生.而那柄利剑,就是正视自己,只有正视自己,我们才能拥有精彩成功的人生!(不知可否满意?)
晏吉径4662三年级下册种花作文150字到200字 -
糜阁壮15540283489 ______ 暑假的一个下午,我和同学们到学校去玩. 我们看见学校花坛里的花开得很鲜艳,就走过去.我发现烟子花开过之后,结出了又小又黑的种子.我想:“把种子带回家,种在花盆里,有可能长出漂亮的花儿.” 我一边想一边收了一些种子.然后,大声说:“同学们,到我家去种花吧.”大家都说:“好.” 到了家,我们把花盆里的土松动.撒下种子,再盖上土.最后,再浇水.我们大声说:“快长吧!快长吧!” 过了几天,种子发芽了.我常常去浇水.又过了几天,我看见花苗长出叶子了.我高兴极了,连忙告诉妈妈.妈妈说:“你要经常给花浇水,施肥,捉虫,你的花儿才会开得更鲜艳.”我听了妈妈的话.我仿佛看见花儿在对我微笑.
晏吉径4662我的一个株花150字作文 -
糜阁壮15540283489 ______ 我是一株梅花.我虽然没有玫瑰的俏丽;没有百合的纯洁;更没有栀子花的清香,但是,我有我自己那至高无上的品质.冬天来了,大雪纷飞,无数颗小小的雪珠飘落下来,像有一千个侠客在天上漫游;又像有一千个士兵,站在云头,准备跳伞...
晏吉径4662用几句话写一种花 100字 -
糜阁壮15540283489 ______ 玫瑰是浪漫的,牡丹是高贵的,荷花是圣洁的,梅花是傲气的,可我喜欢一种花,她不问世事,像个不食人间烟火的仙女,在一旁默默奉献自己的芳香.春天,是百花盛开的季节,人们只顾在那是欣赏,却忘了在夏天孤芳自赏的她.而她却并不生气,在夜晚送人一丝泌人心脾的清香.