我们学习一个新接触的文档时，常常觉得非常难受，而自己消化了再写教程就非常舒服，这会让人产生一种错觉，就是官方文档没好好写。那么实际上，官方文档为什么长期以来，难以代替第三方教程的存在呢？

80% 的文档都是无效的，所以多数情况下，程序员都不用写文档，原因如下：多数文档都是代码的点缀或者静态的记录已经实现的代码，懂代码的开发人员会直接看代码，不懂代码的开发人员压根不会看。

React新文档有个很有意思的细节：useRef、useEffect这两个API的介绍，在文档中所在的章节叫Escape Hatches（逃生舱）。显然，正常航行时是不需要逃生舱的，只有在遇到危险时会用到。

为什么程序员不写文档？是不想写吗？最近，资深软件工程师 Kislay Verma 分析了背后的深层原因。他认为软件工程师不写文档有以下两个主要原因。

很多产品经理在撰写后台的需求文档时会一脸懵，很多时候不知道怎么开始，这篇文章主要根据自己工作中对后台的理解和需求文档撰写经验进行分享。人员较小的公司，会要求产品经理后台管理和前台界面一起进行撰写。

在开发项目时，我们或许需要一份精致的开发文档，那么使用docsify是不错的选择，docsify是一个文档生成工具，它直接加载 Markdown 文件并动态渲染，同时还可以生成封面页。所以我们只需要写完 Markdown 文

DTD文档模型是DOCTYPE文档声明，是Doucument Type Definition的英文缩写，是文档类型定义；制作一个标准的页面，声明一个正确的DOCTPYE，HTML里面的标识和CSS才能正常生效.

docsify 是一个动态生成文档网站的工具。不同于 GitBook、Hexo 的地方是它不会生成将 .md 转成 .html 文件，所有转换工作都是在运行时进行。