讲故事与叙事2019storytime.dev
StoryTime：为代码写故事，而不是写文档
Show HN: StoryTime – Create stories about your code instead of documentation
导读
这是一个把代码讲解做成"逐步展开的故事"的工具展示帖。值得写作者一读的地方在于：高赞评论认真追问了"故事"和"说明"的边界——没有冲突、场景和节拍的结构，再好看的形式也撑不起故事；同时也有讲者分享了用分步演示替代现场写代码的具体做法。
可以直接用的写作要点
- 01
讲复杂内容时，与其一次把全貌倒出来，不如像搭积木一样一步步构建、边搭边讲例子，读者的理解负担更小。
- 02
用可控的静态分步演示（点一下走一步）替代现场演示，节奏在你手里，不会因为出错或赶时间而打乱叙事。
- 03
别把"说明文"包装成"故事"：故事需要有场景、节拍、冲突和角色变化，否则读者带着看故事的预期来，会觉得落空。
- 04
给讲解对象设定目标和阻力（它想达成什么、被什么卡住），哪怕是技术内容，张力也来自"想要而未得"。
- 05
"让它能跑"算不上故事里的价值冲突，因为它本来就是每个角色的默认目标；真正的张力需要角色与目的之间的对抗。
HN 评论精选
用静态分步演示替代现场写代码，边搭边讲，节奏可控、读者更易懂。
我很喜欢这种"慢慢搭起来、边讲例子边推进"的讲法。我在演讲里一直这么做，用来一步步过代码而不用现场写代码。比如：点"present"一步步看变化；或者用空格键往前推进。具体做法我也写过文章说明。
sequoia查看英文原文
I like this mode of explaining code things by slowly building up & talking through examples. I have been doing this in talks for a while to go over code bit by bit without live-coding. Examples: 1. click "present" & advance step by step to see transitions https://docs.google.com/presentation/d/1KVMwffTe-aam8Mq7LwfZzXwtlcy-VRHrBPk20x47_zk/edit?usp=sharing 2. Advance with spacebar: https://sequoia.makes.software/composer-talk/#/7/1 I describe the process here: https://sequoia.makes.software/techniques-to-avoid-live-coding-part-1/#solution-2-code-quot-fade-ins-and-highlighting-
故事需要冲突、场景、节拍和角色变化，没有这些的"故事"其实只是讲解，名不副实会辜负读者预期。
用新颖的方式讲代码是好主意，我也喜欢这个项目，但我不喜欢这个名字。这些是"讲解"而不是"故事"（除非我们把故事定义为百分之百的说明）。这里没有节拍、场景或章节结构，没有在冲突中来回推拉的价值（"让它能跑"算不上有意义的价值，因为那是这里每个角色显而易见的目标），没有推进和人物成长，没有潜台词或隐藏动机，没有能动性和悬念——比如代码可能追求某种与自身目的相悖的东西。感觉是在借"故事"这个词做标题党，因为"代码讲解器"听起来没那么性感。
dakom查看英文原文
Innovative ways to explain code is a great idea and I love the project. However, I don't love the name. These are explanations - not stories (unless we consider stories as being 100% exposition). There's no beat, scene, or chapter structure that pushes meaningful values back and forth in the face of conflict ("make it work" isn't a meaningful value - since it's the obvious goal of every character here), no progression or character building, no subtext or sub-agendas, no sense of agency or suspense where the code might pursue something counter to its purpose... Feel like it's a bit of hijacking of "story" in order to make headlines, since "code explainer" isn't as sexy.
同类还值得读
Pixar in a Box：可汗学院的皮克斯讲故事课
Pixar in a Box – Khan Academy
这篇是 Khan Academy 与 Pixar 合作的“Pixar in a Box”项目介绍，用计算机图形和动画制作来讲解数学概念。
讲故事与叙事2015 · 753 分 · 65 评4 条写作要点编辑精选皮克斯的讲故事法则
Pixar's Rules of Storytelling (2013)
这是皮克斯动画工作室流传甚广的 22 条讲故事法则清单，从“从前有个___，每天___，有一天___”的骨架，到如何重写自己讨厌的作品。
讲故事与叙事2018 · 513 分 · 74 评4 条写作要点编辑精选皮克斯通过可汗学院提供免费在线讲故事课程
Pixar offers free online lessons in storytelling via Khan Academy
这篇报道介绍皮克斯与可汗学院合作的免费在线课程《讲故事的艺术》，把皮克斯内部的故事创作方法公开给普通学习者。
讲故事与叙事2017 · 503 分 · 93 评4 条写作要点编辑精选用皮克斯的故事公式说服投资人
Use Pixar's story formula to win over investors
这篇文章借用皮克斯的故事公式（以《海底总动员》为例）来示范如何给投资人讲创业路演故事：先讲目标、再讲障碍、最后讲改变。
讲故事与叙事2021 · 439 分 · 188 评4 条写作要点编辑精选贝索斯如何把叙事变成亚马逊的竞争优势
Jeff Bezos Turned Narrative into Amazon's Competitive Advantage
这篇讲杰夫·贝索斯如何把“六页叙事备忘录”变成亚马逊的管理与竞争优势：用可独立阅读的叙述性文档替代口头汇报和 PowerPoint。
讲故事与叙事2019 · 435 分 · 181 评4 条写作要点编辑精选