导语
本篇文章解决的问题是：“在工作中如何更好地写作”。前端开发在工作中经常需要进行多种形式的写作，这些写作活动不仅有助于技术沟通、知识分享，还能促进团队协作和项目管理的顺利进行，比如技术文档、培训材料、博客等。
工作写作的三大原则
导向行动
在工作的时候，写作的根本目的不是传递情绪，也不仅仅是传递信息，而是要导向行动。举个例子：比如你在群里发了一条公告，成功唤起了大家的注意力，但是不导向到行动上，这是一种极大的资源浪费。有什么事情就直接写出来，尽量不要让别人猜。写执行动作的过程中，我们也尽量少用修饰性的词语，少用形容词。比如，我们给设计师提要求，提的要求是“设计要简洁大方”，那你不如说“设计的配色不要超过三种”“文字不要超过三行”，这就是一个很明确可执行的行动。
用户意识
用户意识是前端工程师的必修课了，但是同样可以运用在在工作中的写作。在工作中的写作，我们可以把自己想象成一个产品经理，写出来的东西就是产品，这个产品是服务于你用户的行动的。要想带着用户意识去写作呢？需要你问自己三个问题：
-
我的用户是谁？他的需求是什么？
-
我的用户理解我的意图吗？他理解起来有什么难点吗？
-
按照我的要求去行动，他会遇到什么障碍吗？比如说，为了让用户理解我们写作的内容，我们可以划出重点，可以加粗或加方括号，或者另起一行，别人就能一眼抓到这个重要信息。还要注意清除歧义，用绝对词汇而不要用相对词汇，比如“快速”“充分”，但是多快算快？多充分才算充分？这些都很难界定。最好还能问一下问对方有没有需要帮助的地方，充分考虑用户感受。
默认公开
在工作中，虽然我们写的东西都有特定的阅读对象，但是无论你的写作对象是谁，你都要把它当作有可能会被公开。这是因为，工作的特性就是高度协作，再加上互联网的传播性，文档一旦发出去，我们没有办法控制它会被谁看到。即使是一份会议纪要，也可能在一年之后展开类似工作时被参考。曾经有这么一篇新闻：公司业务主管给人力发邮件，说明招聘需求。邮件里就写了一句“不要什么地方的人”，这是一封典型的内部沟通邮件，结果不知道怎么回事，就被截屏发到网上。这家公司从此就摊上了地域黑的名声。总之，默认公开就是既要禁得起扩散，又要禁得起时间。
实用写作示例
周报
第一，导向行动。会议纪要要导向的行动是什么呢？是会议讨论出结果，会后才能落实。所以会议纪要一定有一个重要目标：明确接下来的行动。第二，会议纪要的用户是谁？是参会人，会议纪要用来指导他们会后的行动。除了参会人，没参会的协作者可能也需要看这份会议纪要，才能顺利配合工作。所以会议纪要还要注意能够让第三方看懂，不产生歧义。第三，默认公开原则。会议纪要得做好证据留存，方便后人查阅。还要注意，开会前，我提前梳理好这次会议要获得哪些信息，做纪要的时候，绝对不是听到什么就记什么，埋头苦记，这样很容易错过重要的信息，而且很可能你压根就没听懂，只是把字面的意思记下来了。那聪明的做法是什么呢？按方抓药，一边听一边找我需要的信息来记。
复盘报告
第一，复盘报告要导向的行动是什么呢？重要的不是已经发生过的问题，而是下一次得干得好。第二，复盘报告的用户是谁？这是眼前的问题。这篇报告真正发挥价值的时候，不是写完给别人看的时候，而是下一次出现同类问题，这篇报告能起到作用。第三，默认公开。复盘报告，不光要保证现在的人能看得懂，还要让下一个干这件事的人也理解这些经验的价值。
工作计划
这类工作计划最让我们犯难的地方，就是工作计划跨越的时间周期越长，不确定性就越大，很难一下子就给出特别明确的答案。有的同学心里可能会有这样的疑惑，每次都写计划，但是未来变数那么多，计划赶不上变化，写了有什么用？我们可能很纠结，工作计划又难写，又担心写了没用，其实我们可以换一个视角：把工作计划当做一个锚点，在面对变化的时候，它是讨论的基础，不至于毫无抓手。我们不是需要一份完全不用修改的计划，而是先把各个部分的目标来对齐，一起来把握一下大方向有没有走偏。有一个经典的工具：SMART原则。SMART原则是五个单词的首字母缩写，它们分别是：具体、可衡量、可达成、有相关性和有时限性。这是一个好目标需要具备的五个特征。有三点我认为最重要：
-
具体的：具体意味着关键结果是确定的，没有歧义，别人看到了之后一下子就能理解你的想法。这是一个关键结果最基本的要求。
-
可衡量：写作最重要的就是要把关键结果量化。只有把关键结果量化了，我们才有了检验这个目标是否实现的标尺，组织才能判断这个目标到底达成了没有，达成到什么程度了。
-
有相关性：这个关键结果得跟目标的实现真的有关联。这一点也是最难把握的，目标太远了，有些时候我们可能今天设想的关键结果，和最后真实目标实现的方向，一点关系都没有。
总结
在工作中提高写作水平需要明确目标，考虑用户需求，并确保信息的公开性和长期可用性。通过采用上述策略，可以有效地提升写作质量，进而促进行动，提高工作效率。