在我上一份工作中,我們的文檔糟糕透頂,因此我們決定對其進行改造。 這個過程涉及數十人,包括多個項目經理,無數次會議,超過一千小時的工程/設計時間,如果我必須估計的話,可能需要一萬個人小時。 我懇求所有參與者在整個過程中使用 @mintlify,這個過程包括花費數週時間來尋找合適的供應商。沒有人聽我的。 在整個改造完成後,文檔是: >美觀性差 >難以維護, >搜索功能糟糕 >沒有 AI 聊天 >品牌不一致 >沒有 llms.txt >導航頁面時閃爍 >完全沒有針對 SEO 進行優化 >被 LLM 索引的難度極大 最糟糕的是:任何大型更改仍然需要多個利益相關者和數週的時間來實施。 公平地說,這家公司擁有世界上最技術性和龐大的文檔,涵蓋數十種產品。 但切換到 Mintlify 可能會在多年的時間裡為這樣一個面向開發者的產品提供數千萬的價值。 這就是我對 Mintlify 如此看好的原因。沒錯,他們讓公司輕鬆構建文檔。這很好。 但真正的價值在於,隨著這些公司的成長,它們的文檔不可避免地會變得更加複雜,它們需要一個堅實的基礎來構建。 而沒有比 Mintlify 更堅實的文檔基礎了。 ...