太夸张了！华为的这篇技术文档，竟然写了5217页……

今天是周末，小枣君按照惯例在公司加班。

突然，我看到粉丝群里，有小伙伴发了一条消息：

一看到这条消息，我就来了劲——

什么鬼文档，竟然会有五千多页？我们平时的文档，最多也就几百页啊……

为了眼见为实，我赶紧私信小伙伴，要来了这份文档。

发来的时候，文档大小果然非同一般，达到了124.9M：

收了半天，总算下载下来。 然后打开：

哦吼，果然，不多不少，一共5217页。

这是一篇 华为光传输设备OSN 1800的硬件描述文档，主要介绍产品及单板的型号、外观、参数等信息 。

看了一下目录。仅仅是目录，就有84页……

文档正文，一共有33章，小节不计其数……

我又统计一下字数， 一共 大约 是 181万 汉字，或者 366万 个字符（含空格） 。

这是啥概念？红楼梦才70万字，圣经（基督教旧约）150万字，大家可以对比一下。

我仔细浏览了一下这份文档。文档介绍了很多的单板、业务，以及光模块。型号确实非常繁杂，再加上内容基本上以表格和图片形式为主 ， 所以篇幅极为庞大。

部分页面展示：

小枣君也当过好多年的文档经理，深知文档工作的重要性，以及把这项工作做好的难度。

这么说吧——这篇5217页的超级文档，真的是刷新了我的认知。

我个人有以下感受：

从产品的角度来看，通信技术经过这么多年的发展，确实变得非常复杂 。 产品类型多，单板型号多，技术参数也多，想 要逐一 介 绍到位 ， 就需要海量的文档篇幅。

文档的篇幅越来越大，不仅给厂商的文档编写带来了巨大的挑战，也给用户带来了不小的压力。

文档团队 的工作难度，会持续攀升。 我们打开的是PDF版本， 试想一下，使用文档开发工具进行编写的时候， 肯定涉及到 多人团队的协作。几千页的文档， 能够做到不出错，很不容易。更别谈要保证文档的可读性。

华为的这篇文档，格式规范，内容全面。我挑了一部分细看，写得很有干货，堪称质量上乘。行业一贯都将华为文档视为标杆，确实有一定道理。

不过 ， 我还是觉得，当文档内容过于庞大的时候，也许可以通过分册的形式，进行分解。 不然的话， 对于客户阅读和使用，确实会 带来 很大的不便。

这还只是产品手册的其中一篇。 整套文档，一般包括几十本 手册。客户 打开这种文档，估计都会 有很大的 心理压力。

大块头的文档，基本上是作为 手册查询使用，如果真的是拿来一页一页学习， 肯定会直接崩溃。5千多页的文档，如果打印出来，估计也能占满整个书架。

好啦， 最后我再问问大家， 你们遇到过 比这篇更 庞大的文档吗？ 大家觉得，行业里 还有哪些公司的文档写的好？ 哪些写得烂？

欢迎在评论区留言！