跳过正文
Background Image
  1. Posts/

还在用 Wiki/Confluence?你可能在生产垃圾

·1041 字·3 分钟· ·
沈显鹏
作者
沈显鹏

不知道你是否也在企业中使用过 Confluence,或者其他类似的 Wiki 工具。刚接触它时,我觉得这玩意儿真不错:功能强大、支持各种排版样式、可以插入图片、视频、图标,还能查看历史版本,使用体验比 Git 轻松太多了。

但慢慢地,我发现了它的一个巨大问题:每个人都可以创建并维护自己的 Wiki 页面

一开始,这种自由看起来是优势。但时间一长,问题就来了:同一个主题的内容,可能会被不同的人写了多个版本。尤其是在项目或产品从一个团队交接到另一个团队时(在外企这是很常见的操作),新团队成员可能不会在原有文档上继续维护,而是习惯另起炉灶,记录自己的理解。

于是,旧的 Wiki 随着人员流动逐渐失效(原作者可能早已离职),新的 Wiki 内容又不够完善甚至有误。这样一来,知识沉淀不仅没有统一,反而更混乱了。

我始终认为 Wiki 工具本身是好的,但如果缺乏统一的管理机制、没有像 Git 那样的 Pull Request 审批流程,那最终它就容易沦为垃圾信息的生产场。

相比之下,开源社区在这方面反而做得很好。

以 Python 社区为例:

不管是谁,只要对这些文档有修改建议,都必须通过 PR 提交,经过审查、通过 CI 检查后才能合并。而且因为是开源项目,社区用户也会主动参与反馈和改进,这也帮助文档长期保持高质量。

但反观企业内部,就完全不同了:

  • 多人各写各的 Wiki,质量参差不齐;
  • 内容孤岛多,缺乏维护,一旦人员流动,旧文档就“失效”;
  • 更重要的是,内部文档缺乏公开审核机制,也没有外部反馈入口,错误不容易被发现或纠正。

还有一点可能更真实也更残酷:在企业内部,员工缺乏维护文档的动力。因为一个写得面面俱到、毫无遗漏的“满分文档”,可能在某天就意味着你可以被“无缝替换”。相比之下,把关键细节掌握在自己脑子里,才更有“工作安全感”。

所以文档治理这件事,本质上和工具无关,关键在人。在没有文化和流程支撑的前提下,再先进的工具也可能变成信息垃圾的堆放地。

文档和代码其实不分家。在开源社区的经历让我深有感触:真正优秀的人,往往能独立撑起一个团队的质量与节奏。他们热爱技术、主动负责、乐于分享,推动项目健康发展。

反观一些企业项目,问题往往出在相反的方向。当团队成员缺乏主人翁意识,人员流动频繁,或者有些人能力一般却意见最多,最终只会在屎山代码上继续堆。


最后,你是否也有类似的经历?你所在的公司又是如何管理内部文档和代码的呢?欢迎在评论区留言交流。


转载本站文章请注明作者和出处,请勿用于任何商业用途。欢迎关注公众号「DevOps攻城狮」

相关文章

还在用 pip 和 venv?那你可真落伍了,赶紧体验 uv!
·1077 字·3 分钟
uv 是一个由 Astral 团队开发的 Python 包管理工具,它能替代 pip、venv、pip-tools 的功能,提供更快的依赖解析速度和更现代的项目管理方式。
全程记录|PyCon LT 2025 第三天:AI 能取代你吗?
·1468 字·3 分钟
今天是 PyCon LT 2025 的最后一天,主题是 AI and ML Day。分享了几位女性讲者的精彩演讲,以及对数据科学和 AI 的新认识。
全程记录|PyCon LT 2025 第二天:被几位女性开发者圈粉了
·1570 字·4 分钟
今天是 PyCon LT 2025 的 Data Day,主题是 Dataframes、Databases、Orchestration。虽然不太熟悉这些领域,但几位女性讲者的演讲让我印象深刻,收获颇丰。
全程记录|PyCon LT 2025 第一天:我在异国 Python 大会上的见闻
·1826 字·4 分钟
参加了 PyCon LT 2025 的第一天,分享了演讲内容、个人感受以及对 Python 社区的思考。
回国休假的一点感慨:北京的夜,好晚
·867 字·2 分钟
在北京停留的一晚,和同学小聚,感受到北京人下班的晚节奏,以及生活在大城市的压力和挑战。
微软、NASA 都在用?我用业余时间维护了 4 年的项目破百了
·594 字·2 分钟
cpp-linter-action 是一个 GitHub Action,提供 C/C++ 代码的格式化和静态分析功能。它使用 clang-format 和 clang-tidy,支持多种配置和自定义规则。项目自 2021 年创建以来,已被多个知名组织和开源项目使用。