海角论坛

先确定教程只解决一个主要任务

一串论坛讨论可能包含背景故事、多个试验、临时建议和不同人的补充。整理时先选定主要任务，例如“为一次读书讨论准备问题单”，而不是“分享所有读书经验”。任务越清楚，越容易决定哪些材料放进正文，哪些留作扩展阅读。

开头写明预期成果和适用读者。读者需要知道自己最终会得到一页问题单、一个可执行流程，还是一套检查方法。再写不适用的情形：如果教程依赖固定小组成员，那么开放式大型活动可能需要另行调整。这些边界有助于合理使用经验。

经验帖常按“我先遇到什么，后来想到什么”展开，教程则应按读者真正执行的顺序组织。先准备材料，再进行操作，最后检查结果。原讨论中的失败尝试可以保留，但应放到对应步骤的注意事项或失败分支，不必让读者重复走一遍弯路。

每一步最好只有一个主要动作，配一个完成标志。例如“选出三个问题”仍然偏宽泛，可以改成“从笔记中挑选一个理解问题、一个比较问题和一个开放问题；完成后检查三者是否都能指向具体文本”。动作告诉人怎么做，标志帮助人知道是否做到了。

以下是虚构教程片段，演示如何为小型读书讨论准备问题单，不代表实际活动成果。

只写顺利路径，会让读者在第一次偏离时无从判断。可以列出常见偏差及排查顺序：问题过大，就缩小到一个章节或一个情节；大家理解不同，先统一词语和材料范围；讨论很快结束，则检查问题是否只需要“是或否”而缺少理由空间。

排查建议应与前面的步骤有关，避免罗列没有依据的万能办法。没有验证过的调整，可以明确写成尝试方向。也不要把一次成功写成保证结果，尤其当参与者、材料和目标都可能改变时。

如果教程整理自多人讨论，应区分自己的实践、他人的建议和引用材料。能提供普通链接时，连接到原始上下文，并用自己的话说明所采用的内容。未经执行的建议不要写成本人已经验证的步骤；尚未确定的部分也不宜用模糊署名包装成权威结论。

完成后请一个不了解原讨论的人试读，重点问他是否知道起点、下一步和完成标准。需要修订时，说明修改原因与受影响的条件。海角论坛建议把教程看作有边界的操作记录：它可以随着反馈变得更清楚，也应允许后来者发现不适用的情况。

不必为每一步配图。图适合展示结构、位置和前后变化；文字已经清楚的步骤可以直接说明。使用图片时应解释它帮助读者判断什么。

可以整理为有条件的实践记录，明确尝试范围和未验证部分。不要把单次经历写成适用于所有读者的保证。