PRD七坑：没有可读性的PRD都是耍流氓思维导图

第二坑——专业名称重复出现

昨天在写文档的时候，为了使每一个名词都能精确的定位到每个点上，所以每一个名词都使用专业名称来表示，全篇PRD专业名称横飞。由于昨天写的文档是属于纯逻辑性的文档，所以大量在专业名称充斥的情况下，整篇文章的可读性极差。

第三坑——行文逻辑不清晰

在写开发文档的时候，凭着直觉来写文档，在写之前并没有梳理清楚其中的逻辑，以至于最后写出来地文档逻辑混乱，各个板块互相穿插。

在撰写文档前，首先自己要清楚整个功能的流程，这个肯定是毋庸置疑的。但是，我们在写文档的时候，可能就没有这么在意行文的逻辑，全凭自觉来撰写。

所以在写文档的时候，不仅仅需要理清整个产品、功能的逻辑，还需要为整篇文章的结构和行为逻辑进行提前的思考，不然产出的文档可读性也很差。

第四坑——详细得臃肿

在写PRD时，为了想一次性把问题说清楚，让程序员能一次性把文档理解透。所以会把一个问题解释得很详细，从而使得文档变得很臃肿。

这不是认真，这其实是一种懒惰，因为想用文档砸给程序员，让他们自己去理解产品，不想和程序员进行过多的交流和文档解释。

其实在实际工作中，我发现有就算你写得再详细，如果不进行口头介绍，程序员想把如此臃肿的文档理解清楚也非常不容易。所以，如果能用流程图来表述，就不需要长篇累述；如果能先进行产品大致的介绍，让大家先理解整个思路，就不需要文字上过于累赘的表述。

产品文档应该做到“考虑全面，逻辑清晰，语言精练”

第五坑——文档排版不易读

原来才开始写文档的时候，完全不知道什么排版，在无数次打磨自己的格式后，开始对排版有了一点自己的理解。

对于文档排版，统一文字格式后，做好以上几点就能确保文档基本整洁和可读性。但是排版是个长期打磨和锻炼的事情，必须要经常锻炼，才能有一套自己的合理的排版风格。

第六坑——重点内容不突出

第七坑——不用程序员喜欢的形式写文档

最后，特别重要的一点，也是不可不说的一点，那就是使用程序员容易理解的、喜欢的方式来写文档。