设计内容容易过细，但设计阶段是不能考虑特别清楚地，时间也不允许 。
对于这个问题，一个对策是上边所提到的，文档只体现设计上的决策，页面原型所不能反映的信息，详细设计只体现总体设计对模块设计的一些考虑，例如对功能的数据库设计等等，而具体的实现实现，则到代码中再去实现，相关的设计也仅体现在代码中 。
需求、设计需要不断的被更新、构建，则设计文档需要不断的重新调整，文档的维护需要跟上，否则文档和系统的同步就很难得到保障了，且造成多余的工作量 。文档的内容易流于形势，质量糟糕，不能成为开发人员的参考手册，一是要建立起相关制度，如有修改，先改文档，后作开发，从工作流程上切实保障文档与系统的同步，二是要规范文档质量，对文档该写什么，不该写什么，标准是什么，粒度是什么，语法应该如何组织，有明确的标准和考虑，同时，建立审计文档评审、审核制度，充分保障系统的使用 。·
首先是文档的内容，根据项目和团队的不同，详细设计文档的内容也有所不同，一般说来，粒度不宜过细，不能代替开发人员的设计和思考，但要把有关设计的决策考虑进去，包括与其他模块、整体设计的关系、操作的处理流程，对业务规则的设计考虑等，有一个标准为，凡是页面原型、需求规格说明书所不能反映的设计决策，而开发人员又需要了解的，都要写入文档 。
其次是文档所面向的读者，主要为模块开发人员、后期维护人员，模块开发人员通过详细设计文档和页面原型来了解所开发的功能，后期维护人员通过实际系统、模块代码、详细设计文档来了解一个功能 。
再有就是谁来写文档，因为文档主要考虑的是设计上的决策，所以写文档的人应该为负责、参加设计的技术经理、资深程序员，根据团队情况和项目规模、复杂度的不同，也有所不同 。
还需要保证文档的可读性、准确性、一致性，要建立严格的文档模板及标准，保证文档的可读性及准确性，同时建立审核及设计评审制度，来保障设计及文档的质量，另外在工作流程中要强调，要先设计、先写文档，再进行开发 。
4. 概要设计和详细设计怎么写 知乎 撰写的设计文档主要分为：总体概要设计文档 + 详细设计文档，后简称为“概设”+“详设” 。
总设和详设都应该包含的部分：
(1) 需求：一般以产品的语言描述，这一块可以拷贝产品需求文档中的story list部分；
(2) 名词解释（可选）：非相关领域内的同学需要看到文档需要提前了解的一些概念性质的东西；
(3) 设计目标：又分为功能目标和性能目标，功能目标一般是对产品需求的技术描述，性能目标是根据产品给出的数据对性能进行的评估 。一般来说，新服务必须要有性能目标一项，性能目标可能会影响设计方案 。
除了都应该包含的部分，总体概要设计一般还包含：
(1) 系统架构：一般来说会有个简单的架构图，并配以文字对架构进行简要说明；
(2) 模块简介：架构图中如果有很多模块，需要对各个模块的功能进行简要介绍；
(3) 设计与折衷：设计与折衷是总体概要设计中最重要的部分；
(4) 潜在风险（可选）；
输出总体概要设计的时候，很多方案还是不确定的，需要在设计评审会议上确认 。
总体概要设计重点在“方案折衷”，总体概要设计评审完毕之后，此时应该是所有方案都确认了，需要输出各模块的详细设计，详细设计重点在“详细”：
(1)总体概要设计结论汇总（可选）：达成一致的结论有个简要概述，说明详设是对这些结论的实现；