82-21.教练的真相.结构
那上一节课呢就提到说哈写教程是教练的分内之事。
那么今天呢我们首先从结构上审视一下哈所谓的教程。
那简单来讲呢，一个好的教程呢就是针对一个急需解决的问题，给出一个切实可行的方案。
我再重复一遍啊，就是针对一个急需解决的问题给出一个切实可行的方案，这就是好的教程。
这里的关键词有两个，一个是问题，一个是方案啊，当然也可以被称为答案，对吧？
问题和方案。
针对一个亟需解决的问题给出一个切实可行的方案
希望人们认清 比特币的 避险属性呗……
那所谓的问题呢，其实呢无非以下三种，你按分类看看就这么三种啊。
第一种是what什么？
第二种是hy为何啊，第三种是how如何。
关于什么就是whatch这类问题的例子啊，比如说嗯带孩子到外地参加夏令营都需要注意什么或者说有哪些软件可以帮你快速处理图片，或者说贝S斯定理究竟是什么啊，那这类的问题呢啊答案的焦点通常集中在介绍和讲解概念之上，对
？
如果涉及多个概念啊，通常还可以比较啊，比如说这5种快速处理图片的软件，他们之间的优势和劣势啊，给做出一个比较列表。
那关于hy为什么的例子啊，比如说哈啊孩子过刚过3周岁的时候，突然开始出现拒绝对话的情况，怎么回事啊，或者说为什么朗读是最好的自然语言学习新的手段对吧？
又或者说啊养了之后到底可不可以洗头洗澡，就这类的问题呢，答案的焦点是因果关系分析，针对一个现象或者结果给出一个足够合理的分析啊，主要是因果分析啊，并且呢要找到足够精确的原因，然后解释清楚这些原因，给出啊这些原因的啊证据
。
关于how就是如何的问问题的例子是什么呢？
比如说如何使用excel做定投记录，并实时更新收益率啊，再比如说如何尽快学习计算机键盘萌打那再或者说如何练习胯下运球那这类的问题呢，答案的焦点是可行的步骤，那就是可行的步骤。
。
当然了，现实中最常见的是这个这三个类别的组合问题啊。
比如说上面的例子当中，为什么朗读是最好的自然语言习得手段啊？
若是最终写成文章写成教程会自然人变成啊三种基本类型的组合啊比如说你在这个文章里可能要解释清楚最高效的自然语言习得习惯是什么都有哪些？
这就是wa的问题。
然后呢，你还要这个解释清楚为什么朗读是最高效的那这就是为什么Y的问题对然后呢，你还要往下解释清楚如何正确的有效的朗读啊，那这个就是how啊如何所以到最后啊教程的标题可能并不是完整体现所有三个类别。
关于how就是如何的问问题的例子是什么呢？
比如说如何使用excel做定投记录，并实时更新收益率。
比如说哈我再细化一下，那我现在说的每一条都可能会成为教程里的一个段落啊，或者是若干个段落组成的一一部分啊？
比如说哈你可以去论述习得自然语言的手段都有哪些对吧？
然后呢嗯你再去论述哈在这些手段之中进行比较分析之后，为什么我选择了朗读对，然后呢，你可能还要再去写哈，除此之外，朗读还有什么其他好处？
竟然还有很多好处，对，又或者说啊你会写这样一部分，就是实践之后发现了哪些意料之外的好处对？
然后呢，你可能接着又啊有这样的部分，就是如何选读朗读材料啊，如何安排朗读时间，如何制定朗读计划啊，如何监督或自我监督等等等等。
然后呢啊你可能还包括这样的段落。
。
比如说哈嗯在朗读过程当中可能遇到的困难都有哪些？
遇到这些困难的时候，我最初是如何解决的那后来呢有没有更好的解决方案等等等等。
所以你看啊到最后他无非就是啊针对着一个问题，急需解决问题，从三个方面啊多角度入手，要么是what，要么是hy，要么是how。
于是呢你去看啊，从这个角度去看天下所有的教程，所有的好教程，从结构上来看，就这点东西的，就这么三个词，就这么三个要素，就有这么三个类别。
最后呢这三个要素各有各的焦点啊，然后呢到最后针对这三个三种问题的答案，要求都一样的。
要求都一样的，都是什么呢？
六个字清晰准确必要，六个字清晰准确必要。
what就得清晰准确必要。
无论是定义还是分类还是比较Y就得严谨因果关系就得清晰准确必要。
好，就得步骤完整啊，每个步骤都必须清晰准确必要，确保可行。
所以呢好的教程第一要素就是从结构上来看，每个要素都要做到清晰准确必要。
实际上翻来覆去就这么三个要素嘛。
然后呢都要清晰准确必要。
啊，措施哈就是统一一下，就是教程的核心就是问题和答案。
对，当然也可以被称之为方案，对吧？
就是问题和答案。
那写出来的教程的结构呢，既然骨子里是问题和答案。
那么写出来的结构自然就是这么相应两个部分嘛。
第一部分是问题的陈述，第二部分整个啊是答案的论述。
。
这里的第一部分呢嗯就很简单，就是要把问题描述清楚嘛。
那你去写这个描述的时候，要求是什么呢？
其实很简单嘛，就这么8个字叫重点突出简洁明了啊，重点突出简洁明了，就是第一部分啊，你需要做到的事情。
第二部分呢其实是还可以拆分的对啊，就是第二部分答案是可以被拆分的对吧？
那比如说你可以拆分成这么三个。
第一个呢叫前提。
第二个呢就叫阐述。
第三个呢叫总结。
这个前提呢指的是什么呢？
就是这个细息的作者呀，他会分辨读者当前状况，哪些是这些读者已经知道的，哪些是他们需要进一步学习的。
为了完成整个对答案的理解，他们都需要哪些前提条件呢？
通常情况下哈零基础就可以开始做的事情是很少的。
就算有也不大可能有太多的实际意义。
所以呢如果有必要的话，就得有一个简单的前提条件告知与罗列，就是你在想看看懂这篇文，看懂看懂这个这个教程啊，然后呢啊能够成功实践这个教程啊，你都需要哪些基础知识呀这个叫前提。
阐述部分当然是整个教程的核心啦，对吧？
最重要。
但其实呢也最为朴素。
这个阐述部分是干什么的呢？
这他就是大白话摆事实讲道理，或者陈述清楚步骤，对吧？
那语言的要求呢，那当然要是通俗易懂，但是要逻辑严谨，论证要清晰，举例要做到准确的，同时还要做到说有趣啊，步骤呢要讲解的足够完善细致无误，对吧？
好的习惯是运用语言的时候要形成并遵守一定的规范。
而后呢就是总结。
那阐述的部分呢可能是把一句话展开啊，变成一篇文章。
而总结的部分呢是把之前所有内容尽量少的几句话就解释清楚啊，就是让读者阅读过后可以迅速回顾整理啊，在大脑当中回忆这些内容。
于是呢到最后哈一个比较完整的教程模板大概长成这个样子。
上来呢那是第一部分就是阐述问题，然后呢给出答案啊，这里面呢有啊关于这个答案的前提以及关于这个答案的阐述，最后呢给出一个总结，对吧？
然后呢还可以添加一个辅录，对吧？
如果必要的话，最后这个添加的辅录呢，其中有一个叫进一步指引即在之前那些前提条件基础之下，把当前的知识消化之后，进一步可以学习什么？
进一步可以干什么？
下一步可以干什么？
whats next还有哪些文章可以进一步阅读，进一步学习。
还有一个可能出现的就是什么呢？
啊，参考条目就好像是非机构类书籍末尾的参考文献那样，把重要的参考资料出处或者是链接罗列出来，以便将来需要的时候可以直接访问，而不是。
而后呢也许还应该有一个更新历史。
其实因为很多的时候啊，这个教程呢必须与时俱进。
那有些步骤呢是需要优化的了。
有些理由呢是需要补充的了。
有些概念呢可能需要重新定义了等等等等等等。
于是呢要在更新历史当中罗列重要的更新关键啊，太过细索的。
比如说错别字修改什么就没必要罗列了。
那很多的时候呢嗯大家要知道的这个教程是需要维护的。
若是做不到及时更新，它就会失效的那就意味说之前的工作浪费。
，所以一些好教程哈，它从来都不是一次性的工作啊，他是需要长期持续维护，实时更新也是教程创作者的分内工作。
最后呢，如果一个教程是写给大众看的，而不仅仅是写给自己或者家属，那么就应该对各自的来自各个角度的疑问啊呃进行回应对于是呢可能还有一个叫常见问答集啊FAQ那这是最锻炼作者哈周全能力的，也是教程作者啊能够最能够体验到积累效应的地方
。
啊就是到最后你日积月累，你可以回答所有的问题，无论那个角度有多么刁转。
在了解以上基本结构之后呢，我们需要限定一下哈语言的使用。
就是首先呢大家明白哈，教程呢是知识的传递，传递的决定对象决定了说因为传递对象是知识嘛，我们应该使用的不是毫无规矩的，毫无约束的自然语言，而是毫无歧义的人工语言啊，这一点非常非常的关键。
毫无歧义的人工语言
这里面的毫糊歧义啊是最基础的要求。
你知道吗？
就说嗯因为世界里有危基百科，那中文世界里最懂中文的百度啊，总是号称自己最中懂中文的百度，有个百度百科，你知道他们的关键区别在哪里吗？
关键区别在于说百度百科其实是没有语言规范的。
而危基百科不仅有还很完善。
你别看这一点点的差异啊，最终造成的，那就是天壤之别嘛？
。
举例来说哈，在陈述时间的时候，在危机百科上是不可以使用相对时间词汇的。
因为相对时间词汇将不可避免的造成歧。
比如说你在危机危机百科里写的，竟然是最近或者去年怎么怎么样。
那这时候明天人家来看文章的时候，你今天发文章，我今天看啊，那我知道最近是什么时候我也能弄清楚啊，因为我你昨天发文章，我今天来看，今天是2023年，所以你说去年我知道那是2022年？
可是随着时间流逝很久之后，我才看到你的文字，那我怎么知道你说的最近是什么时候，我怎么知道你说的去年是哪一年这点就是这一点点的差别，就危机是有这样的语言规范的，不能使用相对时间，你到百度上去看啊，遍地都是最近啊，遍地都是啊最近十年去年那就没法看了
。
另外一个呢就是一定要使用正常正确的词汇，而不是使用时髦的说法。
其实呢也是基于同样道理的。
举个例子，那你就举个例子，你非要生非要写成举个例子，就是抄板栗的例对吧？
啊，可怕你非要写成阔怕，对吧？
嗯，这样子你非要写成酱子等等等等。
平日里说说说话这么说着玩有没问题的。
那写教程，这就是坏习惯，白痴行为。
这种当下看起来时髦的语言，它是没有生命力的，过段时间就被弃用了，于是呢你整个教程会因此变成了就是特别蹩脚的破玩意，这一点呢就是说大家有空的时候可以去翻一翻哇搜一搜出版社编辑指南，出版社编辑指南，任何一个出版社都有个简单的编辑指南的，应该认真去看吧，遵守一下语言规范
。
到最后呢就是连文字排版都应该养成好习惯。
比如说为了教程在网上有一个好的呈现。
中英文混排的时候，汉字与数字之间，汉字与英文字母之间都应该加一个空格的啊，左引号啊和之前的啊字符之间啊，右引号和之后的字符之间啊，应该加个空格的啊，由于全角字符的视觉特殊效果，破折号和引号之间也应该有空格的，但破折号和书面号之间就不需要有空格了，，就是光一个空格都需要研究很久，当然刚开始的时候哈会觉得麻烦，虽然如此，但是一旦你养成了习惯也就没有麻烦了
。
它只不过是好习惯而已。
对吧？
。
再次重申一遍哈，所有经常写教程的人都体验过的，就是你自己写出来的教程。
更多的时候，其实主要是自己向未来的自己传递信息，就写作的核心意义。
这是自己向自己的未来的自己传递信息啊，只是我反复说很多遍都很都不过分的对吧？
在好多课里，我也都讲过这个那个复杂的知识与技能，总是需要不断访问的。
于是呢很久之后早就忘了一件事应该如何做，关键细节是什么？
但是呢还好我记得我自己写过这件事的教程呢。
于是呢你就可以翻出来看干净利，按部就班就把事情做好之后，那心情舒畅，于是呢哪怕是只为了对得起未来的自己啊，也要做到很多细节上的完善。
而那些从来不写教程的人永远都不会知道这种细节带来的好处。
好，我们下节课再见。