技术讲故事的叙述
这篇博客文章是Trailhead内容创建者系列的一部分。 跟随 Trailblazer 出版物阅读整个系列。
我整夜都没睡。 我真的不明白,这真是困扰我。
“做一些不同的事情,”我们的主编建议。 “你必须冒险。”
那是什么意思呢? 我正在写的功能与从API生成日志行一样令人兴奋。 哦,等等,这正是我正在写的功能。
所以现在我躺在黑暗中,整夜头痛的痛苦陷入了困境,对于我如何将那些平淡无奇的东西变成足以让它成为特雷德黑德家的东西感到沮丧和无知。
我该如何将一些平淡无奇的东西变成足够有趣的东西,使其成为Trailhead的家?
几个小时后,在工作中,我护理了一杯咖啡,悲惨地凝视着我的日历。 我只剩下几天来完成模块的初稿,而我所要展示的只是Google文档中的一些注释。
就是在那一刻,我瞥了一眼我的同桌好友Mysti,他白天是资深的技术作家,晚上则是犯罪小说的作家。 我的眼睛在她的屏幕上徘徊了片刻。 她正在报名参加作家警察学院的课程。
“那是什么?”
“哦,这对犯罪作家来说是一种隐退。 我们与警察一起工作了几天,以了解他们如何实际解决犯罪,以便我们可以更实际地撰写。”
有一小会儿,我为我永远不会像Mysti一样酷而感到哀悼。 但是那一刻过去了,我的脸上露出了巨大的微笑。 我浏览了笔记,特别是寻找一行。
用例:数据泄漏(例如,用户出口报告并将其带到公司外部)
我读过那行大概一千遍,但我从未想过这种用例对客户的影响。 这是一个完全现实的场景:销售人员被解雇,对被解雇感到痛苦,并决定将其前任雇主的Salesforce数据与他一起用于下一份工作。 也许充满超级秘密线索的报告? 只能由使用我的功能的管理员调查员才能发现的操作? 全部加起来。
当时,Trailhead仍处于起步阶段。 将侦探性叙述纳入技术性文章或与此有关的任何创造性叙述都是冒险的举动。
但是有人告诉我冒险。 用例和故事融为一体,编写起来很容易,所以我全力以赴。
我的努力的结果是事件监视模块。 这是一个只有三个单元的简短模块,但它利用功能使读者进行了端到端的刑事调查。 人们通过阅读API参考或开发人员文档以前所未有的方式了解了事件监视。 他们没有将事件监视视为对象和字段的集合,而是将其视为有价值的工具,可以用来发掘线索并解决组织中的奥秘。
故事真正有趣的是,它们吸引了您大脑的多个部分。 无论何时阅读某些内容,无论是API限制表还是Trailhead模块,您的大脑都会将语言解码为含义。 但是,当您将一个故事付诸实践时,您的大脑就会得到真正的锻炼。 为了解释一个故事,控制记忆,情感和感觉的大脑区域全部亮了起来。
为了解释一个故事,控制记忆,情感和感觉的大脑区域全部亮了起来。

所有这些激活为您的大脑提供了阅读内容。 您会找到与故事中呈现的人物,处境和感觉相关的方法。 结果,您比阅读事实更有效地将信息内部化。
但是,关于故事的最好的部分不是我们向他们学习。 是我们喜欢他们。
我们迫不及待想告诉我们的朋友周末发生在我们身上的疯狂事情。 随着书的情节逐渐接近,我们坐在座位的边缘。 一个好故事,无论我们是讲还是听,都会带给我们快乐。 因此,为什么我们在Trailhead中使用故事并不奇怪。 真的,这很简单。