169-【视频版】3.21 教练的真相. 结构

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