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

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

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

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

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

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

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

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

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

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

  不过，我依旧是觉得，当文档内容过于庞大的时候，也许能够最终靠分册的形式，进行分解。不然的话，对于客户阅读和使用，确实会带来非常大的不便。

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

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

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

  特别声明：以上内容(如有图片或视频亦包括在内)为自媒体平台“网易号”用户上传并发布，本平台仅提供信息存储服务。

  特斯拉推送 2023.44.30.8 车机更新：OTA 改进自动辅助转向功能

  男子吐槽学校墙上挂的名人，以前都是挂着科学家、教育家等等。现在......

  “重庆农妇卖150碗粉蒸肉被判赔5万”案迎最终结局：原告撤诉 原判决被撤销

  四巨82+16+13取三连胜：快船20战17胜逼近前3 乔治提前续约稳了？