艺术界的技术写作课程
这篇博客文章是Trailhead内容创建者系列的一部分。 跟随 Trailblazer 出版物阅读整个系列。
“画出你所看到的，而不是你所知道的在那里。”
那是几十年前一位绘画老师告诉我的。 我曾作为编辑和作家从事文字工作，并决定学习一些有关绘画的知识。 因此，我在当地社区中心报名参加了基础绘画成人教育班。
在第一堂课上，老师在课间桌上放了两根窄木棒，每根长两英尺。 他让我们在桌子周围走来走去，发现棍子看上去和房间的不同地方不同。 他们看起来更长或更短，似乎处于不同的角度。 他告诉我们，我们知道木棍的长度和宽度是相同的，但是根据您站立的位置，木棍看起来并不一样。
然后他说：“停在你的位置，画出你所看到的，而不是你所知道的在那里。”
我的台词很胆小，甚至不直。 但是当我在快速拉动支杆几次后站起来时，我注意到角度和长度都非常接近我所站立的位置。 而且，甚至更好的是，我取得了足够的成功，使我得以继续上这门课，而且（事实证明）还有更多。
老师本可以从很多技术知识入手-有关用于不同类型绘图的正确工具，如何削铅笔和握铅笔，有关各种纸张等。 在其他有关绘画的课程中，我学到了很多，甚至更多。
但是大多数情况下，我在第一堂课中学到了一些技巧，可以将注意力集中在我尝试绘制的内容上，而不必更多地关注外观。
我学会了如何仔细观察光明与黑暗。 如何看到负空间-物体周围的空间。 如何查看和衡量比例。 进行艺术似乎更多地是关于外观，而更少地是关于以正确的方式使用手和手臂或选择正确的颜色或阴影。 我看的越多，就越能看到和理解我要代表的对象。 看到的越深，我对自己正在做的事情的思考就越少-我的手试图将线条和颜色应用到纸张上-而我创造的越多。
要从崇高的话题变成我的实际话题，请快进到今年年初，那时我正在编写我的第一个Trailhead模块。 我的经理（我称他为“菲尔”），我不断处理我的其中一份草稿。 我正在写有关如何设置Sales Wave的信息，这是来自Salesforce的应用程序，可用于对Sales Cloud数据进行分析。 您在配置向导中回答问题，单击“创建”，瞧！Sales Wave为您提供了一组仪表板，这些仪表板以清晰的可视化方式展示了您的机会和客户。
使用配置向导需要大量的思想和对数据以及应用程序工作方式的一些理解。 在与开发团队合作之后，我对这两者都了如指掌，并且花了很多时间和精力来解释细节。
在规划行程时，Phil和我决定最重要的事情是讲一个清晰而引人入胜的故事。 角色需要可信，他们需要具有使用Salesforce执行实际任务的现实经验。
Sales Wave足迹的其余部分很容易就位。 但是配置向导中的单元很困难。 我以为我们不得不做很多解释，否则会对客户造成伤害。 他认为这些解释减慢了叙述的速度。 我们来回走动，直到Phil在下午审查我们的最新草案时说：“也许您不需要告诉人们您对Sales Wave的了解。 也许我们只需要让人们获得一些快速的成功即可。”
“也许您不需要告诉人们您对Sales Wave的了解。 也许我们只需要让人们获得一些快速的成功即可。”
有了这些指导，我回到了办公桌前，思考了客户的体验。 我如何才能给他们他们所需要的东西，以便他们可以利用这些知识并加以运用？ 我如何才能帮助他们快速成功，以便他们想自己更深入地探索？ 我结束了几次向导，第一次接受了所有默认答案，第二次做出了几个不同的选择。 我在截屏之前和之后进行了截屏，以显示对结果显示板所做的少量选择之间的差异。 然后，我制定了供客户遵循的流程，以便他们可以快速尝试并亲自查看。
这似乎可以解决问题。 菲尔（Phil）很喜欢，这就是今天您可以在Trailhead模块中找到它的原因。
那课一直留在我身上。 后来，在编写其他Trailhead模块时，我会为尝试解释该技术而感到困惑。
我会停下来思考一下读者的经验，以及客户使用该技术的经验。
忘记所有的日常Scrum会议，所有产品规格，用户故事，原型以及新功能的工程演示。 仔细观察一个人可能会使用该软件的经历，以及使它变得有用和吸引他们的原因。 然后为该经历写作。
我做了什么 描述客户的体验，而不是我所知道的产品体验。 很像那个绘图老师很久以前告诉我的。
