工作要求,写了一些没用的设计文档

  因为业务需要,公司开始组织写一批文档,如概要设计、详细设计、需求等等。吾运气不错,只写了一个,简单写了一下思路应付过去。

  吾在多个博文中明确说明,所谓的设计文档,确实是没有人看的。没有人看的原因有很多,重要的有:

  • 没有人愿意看文档。为什么呢?看文档就是学习,而学习是非常痛苦的事情。
  • 想了解的东西文档没说或者说不清楚,不想看的一大堆。

  那么文档应该写什么?

  • 文档中主要内容是介绍一下思路、流程,代码关系等等。
  • 千万不要指望看看文档就理解了代码,那是永远不可能的。看文档永远代替不了看代码。看代码自然跟能力相关。
发布了2538 篇原创文章 · 获赞 308 · 访问量 186万+

猜你喜欢

转载自blog.csdn.net/quantum7/article/details/104667241