转载

掘金小册写作参考

掘金小册是 小篇幅 、 高浓度 、 成体系 、 有收益 的内容。既满足读者的学习需求、也满足作者的创作和收益需求，而个中效率的提升就依赖着掘金小册产品模式的优化。

小册主题方向

小册研发的背景介绍（调研用户痛点在哪里？清晰的描述问题的来龙去脉，说明开发者解决这个问题应该具备的能力模型）
小册内容设计思路（如何有效解决问题？有哪些特点？）
小册的主题（突出关键信息）
小册大纲（逻辑条理，模块划分）
适宜人群（受众画像）
学员收益（授课目标）
作者介绍（公司／Title，工作经验／项目经历／博客等）

注意事项

小册的选题和策划思路，一定要明确：从解决问题的思路，和站在用户学习成长的角度去思考写作，目标是 找到一个痛点问题 ， 提供解决方案思路 ， 并打造一个好的教程 ，这跟单纯的通过专栏文章分享个人学习经验或公司内部的经验有定位上的显著区别；
小册作为付费产品，用户阅读体验要求更高，必须做好定位、策划和针对性优化。

几个掘金小册的推荐大纲结构

一、开发实现顺序许多技术类内容都是要顺着具体的开发引导来的，因而按照实现的顺序一层一层、一步一步地讲解，是可以帮助读者从头到尾把内容连贯起来的。以《如何写一本掘金小册》为例：先讲掘金小册是什么，然后读者就会问那怎么用啊？然后就会想要写什么怎么写？然后就是要如何售卖？上线之后有了读者就会思考如何来维护和讨论？有了读者获得了内容就可能出现版权问题？最后，讲明白掘金小册的需求，就希望更多人来写，因而留下申请成为小册作者的方法。
- 第一部分：介绍我们要做什么
- 第二部分：按照实现顺序按部就班地详解流程
- 第三部分：完成的结果，照应主题，留下读者可以继续深入学习、执行的方法…
二、概念到细节很多技术内容的讲解，尤其是一些新的技术，最先要讲明白背后的概念，让读者对这个内容有了一个概括性的了解，然后再深入背后的细节完成实体的内容。以《Git 原理详解及实用指南》为例：Git 虽然为大家熟悉，但它本身是一个分布式版本管理工具（DVCS）及其基本的概念需要让读者先理解。然后来讲一些核心概念，如 repository、branch、stage 等等；然后讲基本操作以及最后的一些工作中会遇到的实用方法。一步步从概念走到细节。
- 第一部分：技术的基本概念
- 第二部分：技术的核心概念
- 第三部分：技术的基本功能和实用方法
- 第四部分：技术的高级实用技巧
- 第五部分：总结 + 深入学习的资源列表…
三：总分平铺还有一种小册的大纲结构是以经验总结、最佳实践、问题解决方案为主的平行内容。这样往往一开始先讲明白小册的核心目的和价值，然后就会围绕主题一个一个讲解决方法、或者一个个的补充内容。以《响应式编程 —— RxJava 高阶指南》为例：小册的目标是去帮助读者理解 ReactiveX 概念和 RxJava 的高阶问题。在第一节解释清楚 Rx 的价值之后就会围绕着 Rx 和 RxJava 逐一讲解概念和高阶问题，但是各个问题之间的关系相对是平行的。
- 第一部分：小册要去解决的问题的重要性和核心内容
- 第二部分：一个一个地讲解内容
- 第三部分：总结…