看了很多文档、gitbook和博客,
发现了如下几种行文风格:
多幕剧式的文章
分阶段,
每个阶段有阶段性成果
一系列续发事件,逐渐演进,
先做一个5分钟的产品,
然后拓展到一个10分钟的产品,
api文档放在最后,
比如react的官方文档
金字塔式的纯理论论证
或者说逻辑论证,
从上往下,
分成三个点来讲,
每一段小标题当然是不能少的
呆板论文式
xxx是什么
为什么要使用xxx
按照这个逻辑来写是挺好的,
但是非要把这两句话放大加粗、当成小标题,
显得冗余,刻板,过分正式
故作谦虚式
一上来一个标题,“浅谈xxxx”,
所以潜台词是:其实我是可以“深究”的,
一“浅谈”, 自己就显得厉害了许多,
谦虚使人猥琐