什么才是优秀的教程之少点哲学,多点显学
Updated on
前言
我是强目的导向型读者,我受不了了,我要即刻开喷。
叠甲:
- 我平等敬佩任何无私产出的慈善家。
- 本文激情创作,以吐槽的形式总结教程类文章常见问题。
- 不论质量如何,我自己就是
勤奋的教程产出者。 - 我平等攻击任何自以为公实则自我陶醉的教程文章,包括我自己。
- 我平等攻击任何看完意义/思路就开爽先于实践的读者,包括我自己。
开喷
暴言一:开局讲意义没有意义!
- 我抱着我的目的而来,我的目的自带意义,你的意义与我何干?我要的是怎么做,TELL ME!
- 你的意义真的有意义吗?你看看有多少意义是不言自明的?开局写意义除了让文章看起来结构完整井井有条还有什么意义?
暴言二:开局讲全局思路无异于传教!
尼玛,教程两小时,“教学”五分钟,剩下全踏马前情提要、心路历程、碎碎念、甚至还来点自谦的叠甲。求求你了,把注意事项简单列下就快点把正文端上来罢!
~~动辄聊思路聊哲学无异于自嗨。~~你讲也就算了,非要讲这么多干嘛?是的,我们常说要知道是什么、为什么、怎么做。但是,我的朋友,你想想看,读者需要的为什么真的是你讲的那些为什么吗?
核心就一句话:尼玛的,少点哲学,多点显学!不要在该讲显学的地方大抒己志,你的哲学在其他主题下自是显学。
另一个极端:知识的诅咒
此时哪有什么哲学?全是显学,还是架构在必要哲学之上的显学!我们怎能要求人保留系统丰富经验的同时还能料想到newbies各种稀奇古怪的问题呢?1
典范
下文这个结构我就很喜欢。在开局就很好地点明了行文架构。你想直接看怎么做?可以!你想知道整体思路?也有!他照顾到了所有人! I don’t want your life story — just show me the rack
是的,哲学你爱讲就讲,干货你爱写就写。只要结构明晰,让读者哪里不会点哪里就是最大的美德!
Footnotes
-
我的歪屁股在此刻相当明显了。嘻嘻。 ↩