今天是周末，小棗君按照慣例在公司加班。
突然，我看到粉絲群裏，有小夥伴發了一條訊息：
一看到這條訊息，我就來了勁——
什麽鬼文件，竟然會有五千多頁？我們平時的文件，最多也就幾百頁啊……
為了眼見為實，我趕緊私信小夥伴，要來了這份文件。
發來的時候，文件大小果然非同一般，達到了124.9M：
收了半天，總算下載下來。然後開啟：
哦吼，果然，不多不少，一共5217頁。
這是一篇華為光傳輸器材OSN1800的硬件描述文件，主要介紹產品及單板的型號、外觀、參數等資訊。
看了一下目錄。僅僅是目錄，就有84頁……
文件正文，一共有33章，小節不計其數……
我又統計一下字數，一共大約是 181萬 漢字，或者 366萬 個字元（含空格）。
這是啥概念？紅樓夢才70萬字，聖經（基督教舊約）150萬字，大家可以對比一下。
我仔細瀏覽了一下這份文件。文件介紹了很多的單板、業務，以及光模組。型號確實非常繁雜，再加上內容基本上以表格和圖片形式為主，所以篇幅極為龐大。
部份頁面展示：
小棗君也當過好多年的文件經理，深知文件工作的重要性，以及把這項工作做好的難度。
這麽說吧——這篇5217頁的超級文件，真的是重新整理了我的認知。
我個人有以下感受：
從產品的角度來看，通訊技術經過這麽多年的發展，確實變得非常復雜。產品類別多，單板型號多，技術參數也多，想要逐一介紹到位，就需要海量的文件篇幅。
文件的篇幅越來越大，不僅給廠商的文件編寫帶來了巨大的挑戰，也給使用者帶來了不小的壓力。
文件團隊的工作難度，會持續攀升。我們開啟的是PDF版本，試想一下，使用文件開發工具進行編寫的時候，肯定涉及到多人團隊的協作。幾千頁的文件，能夠做到不出錯，很不容易。更別談要保證文件的可讀性。
華為的這篇文件，格式規範，內容全面。我挑了一部份細看，寫得很有幹貨，堪稱質素上乘。行業一貫都將華為文件視為標桿，確實有一定道理。
不過，我還是覺得，當文件內容過於龐大的時候，也特許以透過分冊的形式，進行分解。不然的話，對於客戶閱讀和使用，確實會帶來很大的不便。
這還只是產品手冊的其中一篇。整套文件，一般包括幾十本手冊。客戶開啟這種文件，估計都會有很大的心理壓力。
大塊頭的文件，基本上是作為手冊查詢使用，如果真的是拿來一頁一頁學習，肯定會直接崩潰。5千多頁的文件，如果打印出來，估計也能占滿整個書架。
好啦，最後我再問問大家，你們遇到過比這篇更龐大的文件嗎？大家覺得，行業裏還有哪些公司的文件寫的好？哪些寫得爛？
歡迎在評論區留言！
