小时候，一年很长，总是在期盼中迎来新的一年。中年后，发现一年真短。忙碌中，盛夏又至......
挺佩服自己咬紧牙关一步步走过来，收获不小。庆幸自己有一颗粒积极向上、不服输的心；庆幸工作中遇到了良师益友，激励自己不断进步。
可能，它是我职业生涯中最后一次奋斗了吧，带着中年的身躯，入世少年的心态，迎接挑战，平和且努力。知道可能到退休，都无法达到自己想要的精彩，但，也有坦然接受现实的淡定。
尽力就好，为遇到那个更好的自己......
欣然入职
去年2月看到C公司的Job Description时，我认为这份工作对我不会有多大挑战，甚至还有些夜郎自大。想着，自己在美企用英语写了近7年各式手册，积累到的英文技术写作技能应该足够应付任何外企TW工作了吧。
我常对人说，技术写作对语言要求并没有他人想像地那么高。一切文档皆可套用task-based writing范式，关键是：同理心，以及简洁平实的语言描述task的能力，对英语写作水平并没有很高要求。我对自己的技术理解力与同理心颇为自信，计算机专业毕业，加上在电信与IT行业从事TW这么多年，技术+写作的综合素质是我的强项。
一路Teams面试笔试下来，拿到了入场券。入职日是2021.6.7日，高考的第一天。临湖而建的园区，错落有致的楼裙，宽敞时尚的公办环境，庆幸自己为争取面试机会的执着与努力。
站起身，望向窗外，初夏明媚的阳光晒在园区修剪整齐的草坪上；办公区很安静，大多数同事都在家办公，一切都是我喜欢的岁月静好的样子。打开manager发给我的入职任务清单，期待着接下来有条不紊地安装好环境，熟悉工具、产品及公司写作指南......应该有一阵子忙碌的啦，慢慢上手了就会好的，work-life balance是我偏爱外企的重要原因之一。
第一个月
入职头个月，务必保持虚心学习的态度，熟悉公司流程，写作流程与工具，写作风格指南为先；同时，抓紧时间来学习产品知识 （手册，视频培训资料，操作环境）。勿操之过急，对事务的认识需要时间的沉淀。
入职的欣喜，很快被接二连三的工作任务冲淡。
美国Manager, Martin, 安排小J给我答疑，小J同时也要转交他手上的CEM产品给我。入职第十天，小J给我1个CEM产品的新epic (类似new feature)，让我试着一天内写出what's new （类似为新feature写release note，告诉用户what's its value to them)。
前十天，忙于倒腾电脑，装软件，熟悉style guide, 还有就是完成入职一月公司与文档组分配的一大串视频学习任务。回家没闲着，抓紧早晚时间学习CEM（Endpoint Management)手册，可终是没有搞明白它是干什么的，怎么工作的。在没有摸清大方向之前，陷入了对产品细节的追究中，未知的雪球越滚越来。
加班加点一天之内现次通读了文档，然后，到JIRA里，把epic相关的所有关联的story都看了一遍，晚上拉着LG给他讲讲我对产品的认识，一起讨论新feature（主要是开发还没认全，还有就是他们也基本远程办公，我还摸不清与他们打交道的正确方式），从早上6点起床，忙到晚上11点上床，好歹写了出来。
小J看过后，并不满意，而我觉得我对这个feature的理解没有错，应该是措词风格导致他的不认可。争辩几句，搞得两人都有些不开心。工作能力与人际关系的双重碰壁，沮丧，委曲，自我怀疑一股脑涌上心头。
小J是位 tough but nice的伙伴。他缓了缓说，他或许在tutoring我上有些着急了。他将他已写好了what's new给我，让我直接用他写好的what's new，然后完成相关inline article更新即可。我对比了两人的版本，也心服口服，他的版本的确逻辑通顺，文字简洁。
对于CEM手册，有三位同事共同参与写作，另两位是美国同事。每个epic基于CEM文档库(repo)建new branch；在new branch上对文档article进行修订与更新...之后，让开发直接审阅branch上的updates...checkout, pull, commit, push... 按步就班似乎就可以完成每一步，但与git打交道，并不是说有guideline就会一定成功，总会遇到各式问题，对生手，效率颇低。
入职一个月，我所有的业余时间都投入在各种学习之中：产品，Git原理，公司与组内的长长的线上培训清单。那一个月，每周二次的晨跑都停了下来，心头疑问积压了一朵又一朵，理都理不清...... 只想着，争取一切时间多学习点，心里的疑惑就会少一些。
挑战之1, 2, 3... N
一个月后，我逐渐接过了J手上的CEM产品。同时，Manager安排我接手PVS/MCS产品，与另一位美国TW Josh合作，他会每两周指导我对PVS/MCS产品的学习。
Agile开发体系下，产品以快速响应市场需求、快速面市、快速调整著称。在C公司，一个TW通常负责2~3个产品，TW不单要负责手册更新，还需要参与UI设计以及UI copy的review。我一直对品质有一定的要求，希望自己在有限时间内做到最好。而在某些工作上（比如what's new, UI Copy)，当我又不具备这种能力时，我会把所有可以投入的时间都投入到工作中，工作与生活的平衡一下子全被打破。这一年里，基本都是这样...经历了多少汗水与沮丧，个中滋味如人饮水。
翻看blogs，满满记录了我这一年里，接触与学习的新技能：写作工具Markdown + Git，新的写作领域UX Writing、Marketing writing、以及Error message writing。
- 新型写作工具： Doc like Docs (Markdown + Git)
第一个接手的产品是CEM，文档是中美两地多人合作。大家共同维护一个文档repo库，每个新feature新建一个branch，最怵的便是merge conflict。每每遇到各种报错信息，那时的手足无措与惶恐，历历在目。疫情这一年，大家都基本在家办公，对新人来说，真的太难了！
Git作为代码版本管理工具，可能对于天天与代码打交道的开发来说，已修炼到处世不惊。但对于我，一个用了二十多年专业写作工具、一贯小心谨慎的writer，生怕自己的操作会导致不可挽回的结果，加上一开始对Git的管理能力信心不足，心理压力可以想像。
摸爬滚打中，慢慢成长，学习GIT原理与命令，积累各式报错及处理方法。虽说现在每次release时，还是会紧张，但因为掌握了各种技巧，储备了些workarounds，心理放松了许多--至多是多花点时间重新branch过。
Blogs： GIT学习总结 I，GIT学习总结 II，GIT学习总结 III
- Web文档：如何抓住用户眼球
页网形式发布文档是IT企业通用做法。而我的经验集中在PDF形式的纸质文档或是在线帮助文档。脑子里并没有概念：对于不同的媒介，眼睛在扫描与捕获信息的方式会有所不同。直到我在学习Microsoft Manual of Style时，看到一章，明确描述了用户的网页阅读的特点与习惯，并给出了Web文档页面布局的指导策略。
当时我正在啃CEM手册，作为读者，对如何运用这些策略来提高CEM文档的可扫描性（scanability)，有些了想法。于是，写了篇blog，摘录出指导原则，并结合这些原则点评了CEM文档的可改善之处。
Blog: Strategies for text for Web
- Marketing writing
文档中的What's new很像marketing writing，也是我以往未接触过的写作领域。
经过这一年的实践、积累与总结，感触最大的是，要写好what's new，TW需要内化feature，能用自己的语言描述出这个功能，只有用自己的语言讲得出这个feature对用户的value，才可能有后面从简洁平实的语言把思想呈现出来。也就是说：1，要有business sense 2，形成自己的思考与认识，3. 把思维转化为文字的语言能力
为了快速上手，我分析与整理了Microsoft Intune中what's new的范式，并在网上搜寻出三条我觉得很有启示的guideline。有时，在困惑无解时，翻出来回顾一下，还挺管用的。
Blogs: 如何写what's new与Learn from Edits -- What's new blurbs
- UX writing
UX writing将TW工作推向显性化的最前端：要求对产品有正确深入的认识，对语言的简练与准确要求高，另外，对以往产品的整体语言特点要熟悉，做到风格一致--体现产品熟悉度与写作水平双重软实力。
我从去年9月底开始，正式参与UX writing。9月我全面接手UPM (Profile Management)产品。UPM是个偏底层的系统软件，通GPO (Global policy object)让IT admin管理用户profile。从去年7,8月份，我就开始通过手册来学习这个产品，网上相关视频很少。直到2203，随着日常与开发交流的深入，我才算对它有了一个较为深刻与全面的了解与认识；知道了它的竞对产品，多了一个学习的渠道。
每个UPM策略都会出现在GPO editor下，并界面上提供policy description，指导IT admin了解policy并完成配置激活操作。开发（中国同事）会提供初稿，TW的工作是对文本进行编辑与优化。
我清楚地记得每次接到review policy description任务，都意味着反复推敲与左右纠结的几天。首先，花上几天学习concept spec，了解这个policy；然后，对照开发的初稿，把自己放在用户的角度，体会policy是否好懂，是否需要调整描述逻辑及增删内容。最后，是对语言进行优化。我时常会想出两种方案，纠结其中哪一个对用户更友好。
今年2月，我又接手IPS (Image Portability Service)的UX Writing工作，后来又陆续参与了App Packages以及decoupling image的UI copy工作。小J也开始让我reveiw他的一些UX writing。
其间，我在Microsoft文档库时找到了UX writing guideline，对指导UX writing，自我评判备选方案的优劣用处很大。欣喜地摘录了系统性原则，其中倒金字塔原则，让我更加明确了UX描述的顺序--首先抛出结论（也用户必须掌握的最基本的核心内容），然后渐进式倒拨洋葱似的把用户可能感兴趣的东西呈现出来。
对于编写UI copy我的感触是：首先，理解产品功能，保证呈现正确的信息；其次，必须有一套方法论作为指导：何时用descriptive statement, 何时instructional statement, 如何保证UI操作文字风格的consistency。当然，新增UI copy还必须与现有UX writing的风格保持一致，同样很重要！尽量拿到现在UX text库（比如代码里会有json file记录所有的现在界面文本）
- Error message writing
觉得一项新任务很难，很大原因是手边没有一个可信的方法论。因而，在实际工作中，举棋不定，花费大量时间，反复探索，最终还是拿不定哪个方案效果会更好。
接到UPM error messages优化这个临时任务时，手头几个项目正在紧张进行中，时间表本来就很紧，又临时接手一个没有样板可套的review与优化工作，急得要上火。
但基于UX writing的经验，第一步我就是在microsoft里找相关规范，做到有理可依。然后，结合UI界面设计，与开发lead敲定与UI最为契合的Error message的组成元素与表现方式。之后，文字梳理与优化的工作进行得就比较顺利。觉得有逻辑不顺畅的地方，找开发沟通，了解细节，理顺逻辑，简化与统一表达。
Blog: Guidelines for error and warning Messages
- 产品学习与摘录
这一年前后参与写作过CEM, UPM, ITSM, Web Studio, Linux VDA手册，参与review过WEM, PVS, MCS手册。在工作中学习，对公司整个产品体系有了全面与较深入的认识。此外，由于我们的产品与Microsoft Azure服务绑定紧密，产品相似度高，系统地阅读了Microsoft Intune, Virtual Desktops, Virtual Machine, Azure AD 与Azure AD DS手册。
在了解产品的过程，对于需要动手配置的产品，我会在环境中试用，这样既可加强理解，又可以把一些相关知识点串起来，慢慢对系统有整体认识。对于关键的知识点，我会做笔记摘录，这样，便于以后复习与回顾。一个知识点需要重复才可能形成较深刻的记忆。做摘录的另一个好处是，你会发现，通过打字录入，你常会发现阅读时没有注意到的信息。另外，摘录也形成了一个语料库，各式collocation有时记不清了，可以很方便地在笔记中找到。
下一步，我打算对这些摘录进行汇总，最好形成树状发散结构，把它们串连起来。
终极挑战
技术写作是门交叉学科，体现的是领域知识与语言能力的综合实力。经过这一年，我深刻地体会到理工出身的同学，必须夯实自己的英语写作的理论知识。
这一年，最耗时间的，最人我纠结的，还是如何让语言跟上思维，写出地道又准确的文字。
小J理工出身同时英文功底深厚，年纪虽轻，但英文理论知识很扎实。每次提供review comments，他都能说出背后的原理，俨然就是公司的英语权威 ，即使是native speaker的PM与PD现在都很信任他。他告诉我作为中国人，在同事沟通时，告诉他们原因，才能让他们信服，慢慢胜得尊重与信任。
接触久了，他让我多读读英文写作的理论书藉。在慢慢适应工作节奏后，我也开始从以前单纯读style guide，转向建立系统化英文写作认知的阅读之路，在读的书很多，进展不快，但总能读到对我有启发的内容，吸引我持续阅读。
最近在读A Handbook of Writing，系统地学习英语的词、句、段落与文章的写作手法。阅读中收获的知识，让我解开了以往的一些困惑。比如：中式英语之鉴中谈到：English normally reserves the final place for the most important idea. 但Martin在edit我的article时，常会把会把我的这样倒装处理方式改掉回来，很不解。在A handbook of writing书中，看到句子分为loose, periodic sentences: A loose sentence puts the main idea before all supplementary information. The reverse arrangement makes a periodic sentence. Loose sentences are easier, simpler, more natural, and direct; periodic sentences are more complex, emphatic, formal, and literary.
The Global English Style Guide也是一本很实用的手册指南，通过详实的事例给出如何面向global audience，写出无歧义的Global English。示例基本都是出自软件产品，可借鉴性，可操作性很强。
点点滴滴的收获让我感到知识的力量与读书的快乐！
Blogs参见：English Skills with Readings （写即会有进步）Revising sentences for variety and style（提高文章的可读性）
路漫漫，语言方面需要提高的地方很多，speaking及listening，特别是speaking待提高之处也很多，可能到退休都达不到小J的水平。小J的口语是我的追求。但好些事，急不来，慢慢来吧。
这一年，坐得多，腰椎与颈椎都比以前脆弱了，腰也粗了一圈。我一般晚8点会跟着抖音谢博士练练操，或是跟着keep习练肩颈瑜伽，一则远离电脑与手机，二则放松腰与颈，尽量把生活过得有张有弛。
45+，心态平和很多：尽心随性。工作事，有则尽力做到最好，无则修心养性。
我的故事系列：
- 给2020年
- 新城市、新生活
猜你会感兴趣：
