有人问我,如何写好一篇技术教程?有趣又有料(纯干货)

关注 ▲晓衡的游戏开发圈 一起共同成、f10526ef5c3f629ea64e5b77cf1dd439.jpeg这是晓衡公众号第 520 篇原创分享

将自己掌握的知识、经验、技能封装成产品和服务,实现多次售卖。

晓衡昨天写的公众号《用时3年半,我成功偷师麒麟子!大神成长心法》,这一句话戳到不少老铁的心了!

有人说,道理都懂,心里也一直想尝试去做,但就是文笔不行,写得不好、不好意思!

如果你是在上班,你这样说,我没什么好说的,文笔不好,确实是有点难,做好你现在专长的就行。

如果你已经都没工作了,还这样糊弄自己,那就是不把自己的生存当回事了!

到底是生存重要?还是面子重要?

但不排除,是你家里有矿,那就当晓衡放了个屁!滚他妈的晓衡,你有什么资格说老子,取关。

......

看了上面这些话,你并没取关、删除,我知道,其实你是知道我,本意是对你好,对不对?那就开始正经的吧!

秒懂 Cocos Creator 组件化开发!今天我就来挑战一下这个选题,试试我能否教会你?

01、顺序

其实写教程类的文章,根本不需要什么文笔!我们又不是搞文学创作,这里我分享一点个人经验,供大家参考。

写教程是将一个操作按 1、2、3 的顺序步骤给讲清楚,比如:如何把大象关进冰箱?

  1. 打开冰箱

  2. 把大象塞进去

  3. 关上冰箱门

没有经验或经历过的读者,当看到,哇!大象怎么可能关的进冰箱呢?这也太难了吧,这样就能实现?

教程一开头,你就应该他看到效果,不要用文字说,最好是给图或视频,甚至是可以体验的DEMO,自己确实做到了!

你都能做到了,自然是能讲的对吧?但,如何让你的教程表变得更有经验的呢?

你可能会使用一些魔法,比如隔空操作就能打开冰箱门,看起来就很帅。

再使用你的独门秘技,可以把大象变小亦或是把冰箱变得更大,可以轻松的把大象放进冰箱,而且还没有副作用。

最后甚至是,让大象自己把冰箱给关上,比一般人还更进一步。

因此,写教程更多的是你有亲身经历过,熟悉过程中的细节,用文字辅助图片、图表等形式,以顺序逻辑将给他呈现出来。

其实,太干货的教程,很难让人读的进去,光是工作就累成狗了,你还要看这么晦涩难懂的教程。

02、比喻

上面这段文字,能让你读下去吗?有没有发现,我上面用了一种方法,叫做比喻!

将写教程这个可能对你来说陌生的一件事,比喻成你肯定听到过的如何把大象关进冰箱?这个故事。

这里就是利用读者已知的事物,通过比喻过渡到未知。如果,还是感觉不够,我再举一个例子:秒懂 Cocos Creator 组件设计!

你有看过《斗罗大陆》吧!国漫第一的哦!

135c4c32cb520155647cf52cadd292a9.jpeg

我这个四十多岁的人都看过,连我女儿一个小学生都看过,而且连他们班上的同学基本都看过,甚至还很喜欢,我想必你也应该看过。

如果没看过,还真建议你看看,要不然下面这段文字你估计就不适用了。我就不好意思了,有什么不好意思的?不好意思的不应该是哪谁吗?我只管输出就是,况且,我已经给你提供了参考。

好,正式开始:秒懂 Cocos Creator 组件设计!

节点就是魂师,面板组件是魂环,一个魂师可以有多个魂环。

组件脚本是魂兽,实例化的组件是魂技。 

有人问哪武魂呢?武魂就是你心里,此刻的设计思想。

写组件代码就是在猎杀魂兽。

将组件代码挂到节点上,就是魂师在吸收魂环。

运行起来,魂师就是在施展魂技。

游戏画面就有了。

其实 Cocos Creator 组件设计模式,对应的是面向对象23种经典设计模式之一的组合模式的应用。

这时再引入组合设计模式、引擎源代码、演示一个案例......将读者从已知带进未知,并感受到收获。

你自己说,上面我说的你有没有收获呢?说真话!如果没有话,算我无能,后面也就不浪费时间了。

03、递进

为什么,我要给你讲这些呢?趁这个机会,我们再深入一步。

这,当然跟赚钱有关啦!晓衡天天研究的就是,怎么帮助有创作能力的开发者赚钱。

我们借鉴一下别的行业,比如去旅游景点会有导游,去博物馆有讲解员,一本书有各种拆书帮、读书会、文字的、语音的、视频的!

为什么会有导游、讲解员、拆书帮、解读员这些专门的职业呢?

如果是自己去玩、去看、去感受、去理解,太费脑细胞了太累了,不论是在认知和体力上都不具备条件,大多数人就只能凑个热闹。

但有了导游,有了讲解员,有了专业的拆解员带着你组织的线上线下,文字的、语音的、视频的讨论交流,而且这种交流讨论绝对不是蜻蜓点似的毫无养分,他的价值就完全不一样了。

一套经典的源代码,就像一个风景区,就像一座博物馆,就像一本武功秘籍!

并且,不仅仅限于它是开源的还是闭源的,是免费的还是收费的,是便宜的还是昂贵的!

都应该有人去发掘它的价值,为用户创造出有价值的新的需求来。

04、小结

最后,我们再小结一下,写一篇有趣又有料的技术教程套路:

1. 先给出效果,让读者有个预期

2. 按步骤顺序,讲解你的亲身经历

3. 适当运用比喻,从已知到未知

4. 再进一步,由简单到复杂,继续嵌套1、2、3步

5. 最后小结一下要点。

如果觉得有收获,请分享给更多的人,更重要的是你要去实践,等你哦!欢迎来晓衡公众号上投稿,带你起飞!

未来五年,我的愿景是帮助1000个开发者实现独立赚钱10W+!

6f4fe409776b8d657f9bd09252ccc5ae.jpeg
欢迎加晓衡微信

游戏开发,技术变现,砥砺前行,共同成长!

推荐阅读

猜你喜欢

转载自blog.csdn.net/6346289/article/details/134978722
今日推荐