要想写好文档很难。技术文档有几种形式：基本概览，高级概览，一步一步的演示，自动生成的文档，等等。考虑下不同用户对你的文档的需求情况：不同的需求，不同的技术，不同的学习风格。你将会发现，没有一种格式能同时适应所有人。

在写项目文档的时候，你首先要考虑到的是读者。最终用户首先需要的是一份入门指南。尽管一些技术概念可能会提到，但是重点应放在用户界面，而不是后台。如果是程序员，他可能会想得到更多的信息：程序运行原理，代码的实现，怎样对代码进行扩展，等等。为部分用户写的文档不应当影响到另一部分用户的阅读，你可以考虑写两份单独的文档，用户使用手册和技术文档。

Jacob Kaplan-Moss在他的怎样写好文档的指南中，他提到了三种文档：教程，专题指南和参考指南。

教程：教程是很重要的，因为这往往是用户在使用新的工具时得到的第一印象。我们之前写到过，有许多不同的工具可以帮你写好教程。如果你想写的话，Kaplan-Moss建议你写得简单快速一些，但是不要太简单了，可以做一个演示，为每一步骤添加相关的截图。

专题指南：Kaplan-Moss说这是文档的主要内容。虽然教程提供了一个高层次的概念，但是专题指南可以让感兴趣的人深入学习，内容一定要详尽。Kaplan-Moss提到，一般来说，图书要胜过官方文档，但是后者的一个优点是随时更新。

如何写好软件文档