Akamai 高级技术作家 Yael Basford 分享了她在技术写作和团队动态方面的经验,探讨了心理学在写作中的应用,并讨论了如何有效合作与反馈。
https://document360.com/blog/navigating-team-dynamics-in-technical-writing/
Akamai 高级技术作家 Yael Basford 谈论了技术写作和心理学如何交织在一起,并分享了她在大型团队和小型团队中工作的经验。
关于雅艾尔
雅埃尔的LinkedIn
耶尔是一位训练有素的心理学家。她拥有临床心理学硕士学位,但决定不从事治疗职业。
她看到一则招聘技术作家的广告,上面说他们不需要任何经验,只需要良好的英语和良好的写作技巧——这就是大约 10 年前她最终从事技术写作的原因。
在加入 Akamai 之前,她还曾在 Britannica、Wix 和 BMC Software 工作。
要点
“为全球技术作家团队工作真是太棒了。我们互相帮助、互相协商并分享我们所学到的知识。我与利益相关者合作,并从他们那里获得对现有文章的反馈。我落实反馈并更改文档。有时我会收到一些我们以前从未写过的全新文章的请求。在这种情况下,我必须与不同的利益相关者进行交谈。作为一名技术作家,我从与用户有某种接口的利益相关者那里得到反馈。”耶尔说。
“与较小的团队合作时,你获得的反馈有限。当我刚开始的时候,我是这家小公司里唯一的技术作家。我有一位出色的经理,他向我解释了有关软件的一切,例如软件公司如何运作、什么是 SaaS 等。但是,与更大的团队合作时,协作和接触的范围是巨大的。”耶尔说。
她还分享了她在网络安全团队工作的经验,表示目标是教育用户并成为单一的事实来源。我们开发的内容主要是教育材料,以及解释网络安全和计算概念的分步材料。
根据 Yael 的说法,当你是一名技术作家时,你是为用户写作的,你需要了解用户已经知道什么以及用户不知道用户期望看到什么。并且,为不同类型的学习者(视觉学习者和文本学习者)最好地呈现信息。所以,它总是为用户着想,这本质上就是心理学。
她认为技术写作是踏入大型跨国公司大门的一种方式。对于非开发人员或编码人员来说,这是一种参与软件开发的方式。
当被问及迄今为止技术写作领域最大的创新时,她说:“基于云的内容管理系统 (CMS) 对我们来说又向前迈进了一步,因为我们可以立即实施内容更新。所见即所得(所见即所得)的管理系统,我认为这是我所见过的最大的创新。”
雅埃尔·巴斯福德 (Yael Basford) 的快速射击
影响最大
Yael 的第一任主教练 Yossi Ben Ishay
强烈推荐资源
这是一个关于技术写作如何提高可用性的博客。该博客的所有者是 Wix 技术写作协会的 API 负责人。
给20岁的自己的一条建议
保持好奇心和谦逊,因为总是有很多东西需要学习。