Nibu,拥有23年技术写作经验,强调作家应减少写作,关注用户目标。他认为文档应更具可操作性,以帮助用户更有效地使用产品。通过减少文档,团队能更专注于战略项目。
要点:
Nibu 拥有 23 年技术写作经验
Nibu 在技术写作领域工作了 23 年,曾在 AOL、Bosch、GT Nexus 和现在的 Whatfix 等公司工作。
他现在的职位主要是管理作者和文档,而不是实际编写文档。
Nibu的支持团队是目标客户
有趣的是,Nibu 的支持团队是 Whatfix 产品(数字采用平台)的完美客户。这意味着 Nibu 的团队自然地融入产品开发周期,就产品路线图提供反馈。
这为产品团队提供了有关其路线图的宝贵见解,同时也确保支持团队随时了解需要他们创建文档的任何新的潜在功能和更新。
上下文内容
Nibu 指出所有内容和文档都必须符合上下文。例如,在开始写作之前,您必须了解用户想要实现的目标。这将使您的写作对读者更具可操作性和有用性。
另一种说法是了解用户在使用您当前正在记录的功能时想要实现的目标。这种更广阔的视野可以让您链接到其他有价值的资源,甚至可以为您的用户建议不同的方法来实现他们的目标或解决他们的问题。
尼布的咒语
尼布说道:
“告诉我,我会忘记,向我展示,我可能会记得,让我参与,我会记住”
他用它来指导他的团队的写作风格,敦促他们在文档过程中包含、展示和吸引读者。
通过更少的写作获得更多的成果
与普遍看法相反,尼布敦促作家实际上少写一点。技术作家需要明白,用户和客户不想阅读他们的文章,他们想要实现他们的最终目标。
所以实际上文档团队的目标应该是帮助产品团队构建更好的产品,随着时间的推移,这将意味着文档团队会写得更少。
如果成功执行,用户将能够通过产品本身有效地解决他们的问题,而无需使用文档。允许文档团队花更少的时间编写文档,并将更多的时间投入到战略项目上。
订阅知识库忍者的评论:
iTunes
Spotify