在我上一份工作中,我们的文档糟糕透顶,因此我们决定对其进行改造。 这个过程涉及数十人,包括多个项目经理,无数次会议,超过一千小时的工程/设计时间,如果我必须估计的话,可能需要一万个人小时。 我恳求所有参与者在整个过程中使用 @mintlify,这个过程包括花费数周时间来寻找合适的供应商。没有人听我的。 在整个改造完成后,文档是: >美观性差 >难以维护, >搜索功能糟糕 >没有 AI 聊天 >品牌不一致 >没有 llms.txt >导航页面时闪烁 >完全没有针对 SEO 进行优化 >被 LLM 索引的难度极大 最糟糕的是:任何大型更改仍然需要多个利益相关者和数周的时间来实施。 公平地说,这家公司拥有世界上最技术性和庞大的文档,涵盖数十种产品。 但切换到 Mintlify 可能会在多年的时间里为这样一个面向开发者的产品提供数千万的价值。 这就是我对 Mintlify 如此看好的原因。没错,他们让公司轻松构建文档。这很好。 但真正的价值在于,随着这些公司的成长,它们的文档不可避免地会变得更加复杂,它们需要一个坚实的基础来构建。 而没有比 Mintlify 更坚实的文档基础了。 ...