今天看到叶伟民老师的一篇文章，瞬间泪目：叶老师，您是懂人性的啊。在我整天鞭策自己“不能再拖了”的关键时刻，及时分享经验：
是的，这篇文章实在是拖了太久，了太久，太久，久……
书接：从0到1的模板插件 | Obsidian实践，有朋友提问说：你有现成的模板，可以分享一下吗？
针对这个提问，第一时间便起草文章，不过写着写着思路散了，便被搁置一边，拖延至今也没有完成……
所以，必须下定决心，花点时间理清思路，把这篇文章继续写完吧。
话说，Obsidian实践，属于个人知识管理的场景。个性化的经验，就很难被其他人直接复用。如果我们把场景，从个人知识管理，切换到日常工作中，信息场景往往会更加聚焦和典型。比如说，产品立场最常进行需求说明；研发立场主要关注概要设计；测试立场也少不了输出测试方案……那么在这种情况下，就比较容易总结、归纳既往经验，形成模板进行复用。
所以我们换个思路，聊聊如何在工作场景中，定义和使用模板。
为什么使用模板？
不过，在切入正题之前，还是想先形而上学地整点儿所谓的“意义”。是因为，
对于使用模板，可能存在一个比较普遍的错误认识：使用模板是应付写作任务的生搬硬套。
所以很多时候我们会发现出现这样的情况，即便是基于成熟的内容模板写作，最终输出的内容质量依然不太令人满意：对模板章节点内容理解错误；上下文缺乏逻辑关联；或者内容不连贯，不自洽的情况。以至于，原本我们希望通过写作梳理和阐述的问题逻辑，依然没能得到很好的体现。
我们通常会认为，模板是对内容和格式的复用。其实这还只是一个方面，更重要的是，模板本质上的体现的是典型的信息场景，其内容是对当前场景的经验和思路的积累和复用，以便高效沟通和解决问题。
所以，无论是设计模板，还是使用模板，都需要聚焦在对问题逻辑的阐述上，才可以更好地发挥模板的作用。
如何设计模板？
设计模板的基本思路是：
明确面向对象；明确信息目标。
基于已有经验，梳理解决问题的思路；
调研信息需求，使思考更加全面充分；
结合上述两者，输出内容架构和写作说明。
首先，明确面向对象和信息目标，对于文档开发而言，是非常重要的。这一定程度上可以看作是“产品思维”的体现，在模板设计阶段，就尽可能聚焦于，典型信息场景要解决的具体问题。
接下来，我们基于已有经验，把当前场景中思考和解决问题的逻辑梳理清楚，这实际上也是对知识、经验进行总结和积累的过程。
为了便于与人沟通我们的想法，还可以通过信息调研、文档评审，或者日常沟通，收集多方的反馈和建议，不断充实完善我们的逻辑叙述。
当我们很好地梳理了自己的思考逻辑，并且充分了解了相关干系人的信息需求，然后通过内容架构和写作说明地方式，将这些内容记录下来，便形成了可被复用的模板。
如何使用模板？
使用模板的基本思路基本相同：
理解目标对象；理解信息目标。
理解模板内容架构；理解阐述问题的基本逻辑。
基于模板，结合实际场景和问题，有取舍地写作。
当我们使用模板进行文档开发时，首先，要沉下心来搞清楚，当前信息场景的面向对象和信息目标——这是我们之所以写作文档的根本动机，是为了高效沟通和解决一个非常具体的问题，并不是“为写而写”。
然后，通过模板的内容架构和写作说明，理解阐述问题的逻辑，以及相关人员的信息需求。而且你有没有想过，如果你是一个职场新人，通过模板继承前辈的工作经验，尤其是思考逻辑，这也是非常好的学习过程。
写作时，不要一味地生搬硬套，有的没的都要硬拽上两句，而是要结合自己要阐述的具体问题，有选择地写作相关内容；也不要东拼西凑，差不多的就往里填，而是要注意行文的逻辑延续，前后文的内容自洽。
如此才能真正达成写作一份文档的目的：高效沟通和解决问题。如果费半天劲写出的文档无法满足信息目标，真就只能是：瞎子点灯——白费啦（蜡）。
关于模板前言
有朋友问说，我们就想就事论事，把文档写得简洁明快一些，不想附加太多不必要的内容，所以前言的部分可不可以去掉？
个人并不建议这样做，因为前言部分就像是文档的“元（meta）信息”，是用来介绍文档基本情况的信息，主要包括：
面向对象，包括需要具备的知识和能力；
信息目标，即文档的使用场景和主要内容；
规范约定，包括但不限于常用符号、数字单位的写法和含义；版本号的定义等；
修订记录，即文档历史和主要变更。
前言的作用可大了：
帮助写作者明确文档的场景定位和信息目标，以及了解基本写作规范；
帮助读者了解文档主要内容，阅读文档需要具备的知识和能力，以及文档内容变更等。
其实，前言中很多内容，可以在制作模板时一次性写好，后续写作时，只需要考虑“是否涉及”，判断取舍就可以，并不需要重复写作。
总结
当我们谈“模板”时，你以为我们在谈“文档”吗？不，我们实际关注的是：思维逻辑、知识积累和高效沟通。
今天的分享就是这些内容。希望你可以从此善用模板，通过设计模板积累知识和经验，通过使用模板学习和成长。
相关文章：#技术文档什么鬼
其他推荐：
实施：GitHub + MarkDown 文档系统的工作环境部署及工作流程说明 | 技术传播
这次他们说好要“讲真的” | 传播
在座都别吵了，你们还有我 | 技术传播
睿齐
技术传播从业者
品牌内容策划
自由摄影师
自由撰稿人
汪力迪
公众号：techcomm / htstory
微信号：bgrichi
邮箱：hash_0813@163.com
被折叠的 条评论
为什么被折叠?
到【灌水乐园】发言
