當前位置: 華文世界 > 科技

太誇張了!華為的這篇技術文件,竟然寫了5217頁……

2024-02-08科技

今天是周末,小棗君按照慣例在公司加班。

突然,我看到粉絲群裏,有小夥伴發了一條訊息:

一看到這條訊息,我就來了勁——

什麽鬼文件,竟然會有五千多頁?我們平時的文件,最多也就幾百頁啊……

為了眼見為實,我趕緊私信小夥伴,要來了這份文件。

發來的時候,文件大小果然非同一般,達到了124.9M:

收了半天,總算下載下來。然後開啟:

哦吼,果然,不多不少,一共5217頁。

這是一篇華為光傳輸裝置OSN1800的硬體描述文件,主要介紹產品及單板的型號、外觀、參數等資訊。

看了一下目錄。僅僅是目錄,就有84頁……

文件正文,一共有33章,小節不計其數……

我又統計一下字數,一共大約是 181萬 漢字,或者 366萬 個字元(含空格)。

這是啥概念?紅樓夢才70萬字,聖經(基督教舊約)150萬字,大家可以對比一下。

我仔細瀏覽了一下這份文件。文件介紹了很多的單板、業務,以及光模組。型號確實非常繁雜,再加上內容基本上以表格和圖片形式為主,所以篇幅極為龐大。

部份頁面展示:

小棗君也當過好多年的文件經理,深知文件工作的重要性,以及把這項工作做好的難度。

這麽說吧——這篇5217頁的超級文件,真的是重新整理了我的認知。

我個人有以下感受:

從產品的角度來看,通訊技術經過這麽多年的發展,確實變得非常復雜。產品型別多,單板型號多,技術參數也多,想要逐一介紹到位,就需要海量的文件篇幅。

文件的篇幅越來越大,不僅給廠商的文件編寫帶來了巨大的挑戰,也給使用者帶來了不小的壓力。

文件團隊的工作難度,會持續攀升。我們開啟的是PDF版本,試想一下,使用文件開發工具進行編寫的時候,肯定涉及到多人團隊的協作。幾千頁的文件,能夠做到不出錯,很不容易。更別談要保證文件的可讀性。

華為的這篇文件,格式規範,內容全面。我挑了一部份細看,寫得很有幹貨,堪稱品質上乘。行業一貫都將華為文件視為標桿,確實有一定道理。

不過,我還是覺得,當文件內容過於龐大的時候,也授權以透過分冊的形式,進行分解。不然的話,對於客戶閱讀和使用,確實會帶來很大的不便。

這還只是產品手冊的其中一篇。整套文件,一般包括幾十本手冊。客戶開啟這種文件,估計都會有很大的心理壓力。

大塊頭的文件,基本上是作為手冊查詢使用,如果真的是拿來一頁一頁學習,肯定會直接崩潰。5千多頁的文件,如果打印出來,估計也能占滿整個書架。

好啦,最後我再問問大家,你們遇到過比這篇更龐大的文件嗎?大家覺得,行業裏還有哪些公司的文件寫的好?哪些寫得爛?

歡迎在評論區留言!