SUSE从单一文档到模块化文档改革，阅读量获得15倍增长
现在确实没人看文档了！不过内容不再以文档作为唯一载体。随着人们的时间碎片化和AI使用，内容颗粒化创作成为趋势。AI学习这些颗粒化知识后，根据用户的问题进行精准回答。
·
今天给你拆解一个特别有启发的案例：国际知名的开源软件公司SUSE，是如何通过一次文档的“外科手术式”改革，把一篇七百多页、让人望而生畏的用户手册，变成阅读量暴涨15倍的“智能文档”的？这背后，其实是所有内容创作者都在面临的一个根本性问题。
SUSE简介
可能有些朋友对SUSE不陌生，这是一家1992年成立的开源软件公司，主要做Linux系统和企业IT解决方案。他们的文档团队不算大，但要维护的内容体量相当可观：核心产品就有68个指南，加上其他团队的补充文档，总共要打理190份资料，还要翻译成13种语言，部分产品的支持周期长达13年，长期下来的维护压力可想而知。
文档编写和使用中碰到的问题
之前他们采用的是和很多企业一样的单一式文档模式。就拿他们最大的《SUSE Linux Enterprise Server管理指南》来说，足足730页厚，要适配4种产品变体，算上不同版本迭代，最后得维护16种不同的文档变体。这种模式不管是对使用文档的用户，还是对内部负责文档工作的团队，都藏着不少问题。
先说说用户端的核心问题：
-
文档不符合用户的搜索习惯，超过80%的读者都是通过搜索引擎查找特定问题的答案，而不是浏览文档门户，这就导致他们找到的内容往往缺少必要的上下文，没法完整理解；
-
文档里包含大量指向其他来源的链接，容易形成迷宫般的重定向，让用户在查找过程中迷失方向；
-
即便做了搜索引擎优化，也获得了SEO审计工具的良好评级，但文档在实际搜索引擎结果中的排名依然很低，用户很难精准找到需要的信息。
再看文档团队内部团队的困扰，文档工程师应该深有体会：
-
内容没法有效重用，不同文档里的相似内容得重复编写，后续修改时又要逐个调整，费时费力；
-
维护工作负担重，一个小功能变更，整个大文档都要翻一遍更新；
-
而且通常是一个作者负责一整篇指南，协作起来很不方便，研发经理在分配工作时也容易遇到阻碍。
文档模块化转型
后来SUSE团队下定决心转型，推出了“SUSE智能文档”，核心就是模块化改革。他们主要做了两方面关键调整：
一方面是发布形式的改变。不再执着于厚厚的单一指南，而是把内容拆成一个个独立的小文章，每篇文章只聚焦一个具体任务，比如“怎么配置sudo权限”，里面包含完整的操作步骤、实践示例和故障排除方法，用户需要什么就看什么，不用再翻遍大文档，也不用来回跳转链接。
另一方面是创作方式的升级，采用“基于主题的创作”。每个主题就是一个独立的信息单元，像积木一样，能在不同文章里重复使用。比如某个产品的基础操作说明，适配不同版本时，不用重新编写全文，只要把版本相关的小模块替换掉就行，80%-90%的内容都能复用，大大减少了重复劳动。
转型前他们还做了充分的概念验证，把同一部分内容分别用两种方式呈现，做了三个月的A/B测试。结果特别超出预期：原来单一文档里的相关章节只获得了755次浏览，而拆成两篇模块化文章后，浏览量直接冲到了11105次，足足是之前的15倍！核心原因很简单，模块化文章能精准匹配用户的搜索需求，元数据也更容易优化，SEO排名自然就上去了。
当然，这个转型过程并不是一帆风顺的，他们总结的几个实用经验：
第一，一定要让文档团队成员深度参与。文档工程师要适应新的创作方式，需要培训和磨合，让大家参与到决策过程中，多提反馈意见，转型推进才会更顺畅。
第二，要让利益相关者认可支持。不管是研发经理还是公司管理层，转型都需要投入相应资源，所以得用数据说话，从最初的问题分析到后续的效果验证，都要有明确的数据支撑，才能争取到足够的支持。
第三，保持灵活调整的心态。转型过程中难免遇到计划外的问题，比如SUSE发现拆成小文章后，需要更高效的文档门户来承载，于是就及时调整优先级，先完善门户再推进内容模块化，没有死磕最初的计划。
第四，结合自身情况选择工具。他们没有盲目更换系统，还是沿用原来的Git做版本控制，用熟悉的DAPS工具，只是给工具增加了模块化支持，既保留了之前的积累，又满足了新需求，这一点对咱们选择工具很有借鉴意义。
获得的好处
最后说说转型带来的实际好处，这也是咱们最关心的：
1. 内容能重复用：单个主题能在多篇文章里复用、组合，不用重复写，省事儿又高效；
2. 协作更顺畅：大家可分工负责不同主题，干活分配合理，配合起来更顺手；
3. 更新更灵活：改单个文章或主题就行，不用动整个指南，跟得上产品迭代节奏；
4. 找信息更快：用户直接能搜到对应文章，不用翻厚手册，用着更方便；
5. 搜索更靠前：模块化让内容更容易被搜到，浏览量暴涨，比如sudo相关文档，比之前多了15倍。
2. 协作更顺畅：大家可分工负责不同主题，干活分配合理，配合起来更顺手；
3. 更新更灵活：改单个文章或主题就行，不用动整个指南，跟得上产品迭代节奏；
4. 找信息更快：用户直接能搜到对应文章，不用翻厚手册，用着更方便；
5. 搜索更靠前：模块化让内容更容易被搜到，浏览量暴涨，比如sudo相关文档，比之前多了15倍。
对于SUSE文档团队来说，从单一文档到模块化文档的转变是一项重大任务。虽然它带来了挑战，但好处是巨大的。通过解决客户和文档团队遇到的痛点，他们改善了单一用户体验和文档流程的效率。
有“AI”的1024 = 2048，欢迎大家加入2048 AI社区
更多推荐
21
0- 0
已为社区贡献3条内容
所有评论(0)