怎么写原理文档

写文档。
写什么文档？
怎么写文档？
什么是文档？
它包含什么内容？

文档是记录、描述一件事、一个东西、一个概念的文字集合，
是一种书面描述。

它可以记录一个人的想法、见闻、感受等等。

它将一切浓缩于文字，浓缩在书面里。

我们可以阅读别人的文档，可以自己写文档。

简单来说，用简单易于明白的文字话语将一件事情讲明白说清楚，思路清晰有条理。

能够将作者的思想准确的呈现在文字里，
让阅读的人读过之后，就像跟作者面对面交流一样，
能够给读者以启发和帮助。

文档的质量好坏，取决于作者的脑袋是不是清楚明白，
取决于作者的表达能力。

写文档可以写自己经历的事情，可以写研究一样东西的收获，
可以写这，也可以写那，
只要主题确定，不离题万里就是ok的。

一般都喜欢看别人的文档，自己很少写文档，
在要写文档的时候，会不知从何开始？
不知道要写成什么样子？
也不知道阅读者什么层次水平。
阅读者也不清楚是不是该阅读那个文档。

因此，在动手写文档前，可以回想一下自己曾经见过读过文档是什么样子？
自己在脑海里先构思一下文档的框架结构，
构思一下自己要写的是什么内容。
然后打个草稿，
拟定一个框架，
在这个框架上面，在添枝加叶，填充各种细节。

就像盖房子一样，
先把架子设计好，然后照着架子，把房子建好。

想想怎么写文档，
其实我现在就在写文档，
文档的主题是《怎么写原理文档》。

言归正传，那怎么写原理文档呢？
在我看来，原理文档，就是将事情的道理讲清楚，
让读者读过后，知其然，知其所以然。

针对自己的主题，有针对性的写，可以适当补充，
但不要喧宾夺主，主题没有讲，却牵扯到别的地方，
这样读者会不知所云。

还是一句话，要写好原理文档，
自己先要将要写的原理吃透了，
自己都不清楚个1、2、3、4、5的，
那也写不出来。

要由浅入深，化繁为简，
如游龙戏凤般，
让读者一读上，就感觉，不错，
是我想要的。

好的东西太少了，坏的东西的太多了，
会给人一种错觉，都是坏的，会给信心带来打击。

有时候，在查阅资料，浏览了一堆书，
尽是没有内涵，甚至还会让人越看越迷糊的书。

要想看一本好书真心是难找。
当你千辛万苦找到一本后，你会发现，原来好书是这样子的，
真的是让人醍醐灌顶，茅塞顿开，怎么就没有一下子找到呢。

看书，要学会看书，学会浏览甄别，什么书只是扫一眼就可以扔，
什么书可以略读，什么书值得精读，什么书值得珍藏。

无论何时，都要读书，会读书，读好书。
人人都可以学习，都可以通过学习来解决问题和烦恼。