Summary & Insights
The very nature of documentation is undergoing a seismic shift, transforming from static reference material written for humans into dynamic, operational infrastructure consumed directly by AI agents. This evolution creates a pressing new imperative: when coding agents and support bots rely on documentation as their source of truth, inaccuracies don’t just confuse users—they cause systems to break. This fundamental change in why docs matter is at the heart of the journey for Mintlify, a company that began by wanting to simply improve the developer experience but found itself at the center of a much larger revolution in how knowledge is created and consumed.
The founders, Han Wang and Hanbi Li, arrived at their current product only after a “year and a half of wandering in the desert” and eight distinct pivots, all centered on helping builders. Their breakthrough came not from a grand vision, but from a pragmatic, two-day prototype built for a friend’s startup. The intense, immediate customer love for that prototype—contrasted sharply with the polite indifference they’d faced for previous ideas—confirmed they had finally found a real problem. This taught them the grace of repeated failure: it fine-tunes your ability to recognize genuine product-market fit when you finally stumble upon it.
Today, Mintlify’s focus has expanded dramatically. While it began as a beautifully designed docs platform for developers, the rise of AI has turned its content into a critical data layer. The company now serves not only public API documentation but also internal knowledge bases, help centers, and HR wikis. This expansion is driven by a new reality: as non-developers use AI coding tools and as engineering teams become responsible for AI-powered support agents, the demand for accurate, machine-readable content spans the entire organization. The product intuition is shifting from perfecting how documentation looks to ensuring the underlying content is impeccably structured and current.
Looking ahead, the founders are most energized by Mintlify’s growing impact on empowering builders at scale and by the novel challenges of building AI agents that can maintain documentation autonomously. They foresee a world where the vast majority of documentation traffic comes from AI, but emphasize that a human-facing interface will remain crucial—not unlike how books persist in a digital age. The core mission, however, remains unchanged: to reduce the friction of turning ideas into reality, whether for an 11-year-old learning to code or a Fortune 10 company deploying a fleet of AI agents.
Surprising Insights
- The “unscalable” manual migration is a permanent strategy: Early on, the founders manually migrated and even edited customers’ docs for grammar and structure. When advised this painstaking process would be temporary, Paul Graham countered that this hands-on, “extra mile” service would be their forever competitive advantage—a prediction they’ve found to be true.
- AI expands the market by making non-developers more technical: The surge in “vibe coders” and people using tools like Cursor means the language of development (Markdown, code blocks) is becoming universal. This serendipitously turned Mintlify’s developer-centric early bet into a tailwind, as entire companies now need a knowledge platform that technical and newly technical teams can collaborate on.
- Documentation is becoming more human-centric because of AI: While AI agents will consume most documentation volume, the need for high-quality, well-structured content actually increases human engagement. Engineers now feel the direct consequences of outdated docs (broken AI agents), creating a stronger incentive to maintain them, and end-users expect sophisticated, chat-like interfaces to query documentation.
- Largest customers are won through casual, hyper-responsive support: Some of Mintlify’s biggest enterprise logos began as casual conversations in their community Slack on a weekend. The founders’ culture of near-instantaneous response to any user, mirroring the pace of their fastest AI lab customers, has been a key and unexpected driver of enterprise trust and sales.
Practical Takeaways
- Seek one ecstatic user over a thousand lukewarm ones: Hyper-focus on solving a single problem so well that at least one person loves your solution. The visceral reaction of a truly delighted user is an unmistakable signal of product-market fit that lukewarm feedback from a larger crowd can obscure.
- Build a “show, don’t tell” prototype in days, not weeks: When you have a strong inkling about a problem, time-box your effort to build the simplest possible prototype. Use it to get immediate, concrete feedback from a real user—often, seeing is believing for a potential customer in a way that a pitch never can be.
- Embrace “doing things that don’t scale” as a core philosophy: Manually onboarding users, editing their content, or providing lightning-fast support aren’t just growth hacks; they are foundational practices that build deep customer love and reveal the exact details of what a scalable solution must ultimately provide.
- Design for the API first, the UI second: As AI agents become primary consumers of content, prioritize the structure, accuracy, and machine-readability of your data layer. A beautiful interface is important, but it’s window dressing if the underlying content isn’t consumable by both humans and machines.
- Let your most demanding customers set your operational tempo: Working with hyper-fast-paced companies forces you to elevate your own speed and standards. Adopt their expectations for responsiveness and iteration—this high tempo becomes a powerful culture and competitive advantage that benefits all your customers.
Những người sáng lập, Han Wang và Hanbi Li, chỉ đến với sản phẩm hiện tại sau “một năm rưỡi lang thang trong sa mạc” và tám lần chuyển hướng riêng biệt, tất cả đều tập trung vào việc hỗ trợ những người xây dựng. Đột phá của họ không đến từ một tầm nhìn vĩ đại, mà từ một nguyên mẫu thực tế được xây dựng trong hai ngày cho startup của một người bạn. Sự yêu thích mãnh liệt và tức thì của khách hàng dành cho nguyên mẫu đó—tương phản rõ rệt với sự thờ ơ lịch sự họ từng đối mặt với các ý tưởng trước đây—đã xác nhận họ cuối cùng đã tìm thấy một vấn đề thực sự. Điều này dạy họ giá trị của thất bại lặp đi lặp lại: nó tinh chỉnh khả năng nhận ra sự phù hợp thực sự giữa sản phẩm và thị trường khi bạn tình cờ gặp được nó.
Ngày nay, trọng tâm của Mintlify đã mở rộng đáng kể. Dù khởi đầu là một nền tảng tài liệu được thiết kế đẹp mắt cho nhà phát triển, sự trỗi dậy của AI đã biến nội dung của họ thành một lớp dữ liệu quan trọng. Công ty hiện phục vụ không chỉ tài liệu API công khai mà còn cả cơ sở kiến thức nội bộ, trung tâm trợ giúp và wiki nhân sự. Sự mở rộng này được thúc đẩy bởi một thực tế mới: khi những người không phải nhà phát triển sử dụng công cụ mã hóa AI và khi các nhóm kỹ sư chịu trách nhiệm về các tác nhân hỗ trợ chạy bằng AI, nhu cầu về nội dung chính xác, máy có thể đọc được trải dài khắp tổ chức. Trực giác sản phẩm đang chuyển từ việc hoàn thiện cách tài liệu trông như thế nào sang đảm bảo nội dung cơ bản được cấu trúc hoàn hảo và cập nhật.
Nhìn về phía trước, những người sáng lập hào hứng nhất với tác động ngày càng lớn của Mintlify trong việc trao quyền cho những người xây dựng trên quy mô lớn và với những thách thức mới trong việc xây dựng các tác nhân AI có thể tự động duy trì tài liệu. Họ dự đoán một thế giới nơi phần lớn lưu lượng truy cập tài liệu đến từ AI, nhưng nhấn mạnh rằng giao diện hướng đến con người sẽ vẫn quan trọng—không khác gì cách sách tồn tại trong thời đại kỹ thuật số. Tuy nhiên, sứ mệnh cốt lõi vẫn không thay đổi: giảm ma sát để biến ý tưởng thành hiện thực, dù là cho một đứa trẻ 11 tuổi học viết mã hay một công ty Fortune 10 triển khai một đội tác nhân AI.
### Những Hiểu Biết Đáng Ngạc Nhiên
– **Di cư thủ công “không thể mở rộng” là một chiến lược vĩnh viễn:** Ngay từ đầu, những người sáng lập đã tự di cư và thậm chí chỉnh sửa ngữ pháp và cấu trúc tài liệu của khách hàng. Khi được khuyên rằng quy trình tỉ mỉ này sẽ chỉ là tạm thời, Paul Graham đã phản bác rằng dịch vụ tận tình, “vượt xa hơn” này sẽ là lợi thế cạnh tranh mãi mãi của họ—một dự đoán mà họ thấy là đúng.
– **AI mở rộng thị trường bằng cách khiến người không phải nhà phát triển trở nên kỹ thuật hơn:** Sự bùng nổ của “những người viết mã theo cảm hứng” và người sử dụng các công cụ như Cursor có nghĩa là ngôn ngữ phát triển (Markdown, khối mã) đang trở nên phổ quát. Điều này tình cờ biến cược ban đầu tập trung vào nhà phát triển của Mintlify thành một luồng gió thuận lợi, vì toàn bộ công ty giờ đây cần một nền tảng tri thức mà các nhóm kỹ thuật và mới tiếp cận kỹ thuật có thể cộng tác.
– **Tài liệu đang trở nên tập trung vào con người hơn nhờ AI:** Trong khi các tác nhân AI sẽ tiêu thụ phần lớn khối lượng tài liệu, nhu cầu về nội dung chất lượng cao, được cấu trúc tốt thực sự làm tăng sự tham gia của con người. Các kỹ sư giờ cảm nhận trực tiếp hậu quả của tài liệu lỗi thời (tác nhân AI hỏng), tạo động lực mạnh hơn để duy trì chúng, và người dùng cuối mong đợi giao diện tinh vi, giống như trò chuyện để truy vấn tài liệu.
– **Khách hàng lớn nhất được chinh phục thông qua hỗ trợ thân mật, phản hồi siêu nhanh:** Một số khách hàng doanh nghiệp lớn nhất của Mintlify bắt đầu từ những cuộc trò chuyện thân mật trong Slack cộng đồng của họ vào cuối tuần. Văn hóa phản hồi gần như tức thì của những người sáng lập với bất kỳ người dùng nào, phản ánh tốc độ của những khách hàng phòng lab AI nhanh nhất của họ, đã trở thành một động lực then chốt và bất ngờ cho niềm tin và doanh số doanh nghiệp.
### Bài Học Thực Tiễn
– **Tìm kiếm một người dùng say mê thay vì một nghìn người hờ hững:** Tập trung cao độ vào việc giải quyết một vấn đề duy nhất thật tốt để ít nhất một người *yêu thích* giải pháp của bạn. Phản ứng bản năng của một người dùng thực sự hài lòng là một tín hiệu rõ ràng của sự phù hợp sản phẩm-thị trường mà phản hồi hờ hững từ đám đông lớn hơn có thể che khuất.
– **Xây dựng một nguyên mẫu “thể hiện, không nói” trong vài ngày, không phải vài tuần:** Khi bạn có linh cảm mạnh mẽ về một vấn đề, hãy giới hạn thời gian để xây dựng nguyên mẫu đơn giản nhất có thể. Sử dụng nó để nhận phản hồi cụ thể, tức thì từ người dùng thực—thường thì, nhìn thấy là tin tưởng đối với khách hàng tiềm năng theo cách mà một bài thuyết trình không bao giờ có thể làm được.
– **Chấp nhận “làm những việc không thể mở rộng” như một triết lý cốt lõi:** Hướng dẫn người dùng thủ công, chỉnh sửa nội dung của họ, hoặc cung cấp hỗ trợ nhanh như chớp không chỉ là thủ thuật tăng trưởng; chúng là thực hành nền tảng xây dựng tình yêu sâu sắc của khách hàng và tiết lộ chính xác chi tiết mà một giải pháp có thể mở rộng cuối cùng phải cung cấp.
– **Thiết kế cho API trước, giao diện người dùng sau:** Khi các tác nhân AI trở thành người tiêu thụ chính nội dung, hãy ưu tiên cấu trúc, độ chính xác và khả năng máy đọc được của lớp dữ liệu của bạn. Một giao diện đẹp quan trọng, nhưng nó chỉ là lớp trang trí nếu nội dung cơ bản không thể tiêu thụ được bởi cả con người và máy móc.
– **Để những khách hàng khó tính nhất thiết lập nhịp độ vận hành của bạn:** Làm việc với các công ty có tốc độ cực nhanh buộc bạn nâng cao tốc độ và tiêu chuẩn của chính mình.
Hãy tiếp nhận những kỳ vọng của họ về khả năng phản hồi và chu kỳ lặp—nhịp độ cao này sẽ trở thành một nền văn hóa mạnh mẽ và lợi thế cạnh tranh mang lại lợi ích cho tất cả khách hàng của bạn.
文件的本質正經歷一場劇變，從為人類撰寫的靜態參考資料，轉變為由AI代理直接使用的動態運作基礎設施。這種演變催生了一項迫切的新任務：當編碼代理與支援機器人將文件視為真理來源時，任何錯誤不僅會困惑使用者，更會導致系統崩潰。文件重要性的根本性轉變，正是Mintlify發展歷程的核心。這家公司最初只想改善開發者體驗，卻發現自己置身於知識創造與消費方式這場更宏大革命的中心。
創辦人Han Wang與Hanbi Li經歷了「一年半的沙漠徘徊期」與八次重大轉向後，才抵達如今的產品形態，所有嘗試始終圍繞著協助建構者。他們的突破並非源於宏大願景，而是為朋友新創公司搭建的務實原型——僅耗時兩天。該原型獲得用戶強烈而即時的喜愛，與先前構想所遇的禮貌性冷淡形成鮮明對比，證實他們終於找到了真實痛點。這段歷程教會他們「反覆失敗的優雅」：它能錘煉你的能力，讓你在偶然發現真正的產品市場契合點時，能精準辨識。
如今，Mintlify的關注範圍已大幅擴展。儘管起步時只是為開發者打造的美觀文件平台，AI的崛起將其內容轉變為關鍵數據層。公司現在不僅提供公開API文件，更涵蓋內部知識庫、協助中心與人力資源維基。這項擴張源於新現實：隨著非開發者開始使用AI編碼工具，且工程團隊需負責AI驅動的支援代理，對精確且機器可讀內容的需求已遍及整個組織。產品的核心思維正從追求文件外觀完美，轉向確保底層內容結構嚴謹且即時更新。
展望未來，最令創辦人振奮的是Mintlify對規模化賦能建構者的日增影響，以及打造能自主維護文件的AI代理所帶來的新挑戰。他們預見未來絕大多數文件流量將來自AI，但強調面向人類的介面仍至關重要——正如數位時代書籍依然存在。然而核心使命始終不變：無論是協助11歲孩童學習編程，或是幫助財富前十企業部署AI代理艦隊，皆旨在降低將想法化為現實的阻力。
驚人洞察
- 「難以擴張」的手動遷移已成永久策略：早期創辦人不僅手動遷移客戶文件，甚至為其修正語法結構。當被勸告此艱辛過程僅屬暫時時，Paul Graham反駁這種親力親為的「額外服務」將成為永久競爭優勢——此預測已獲驗證。
- AI透過提升非開發者技術力擴展市場：「氛圍編程者」與Cursor等工具使用者的激增，意味開發語言（Markdown、代碼塊）正成為通用語。這意外使Mintlify早期以開發者為中心的賭注轉為順風，因為整個企業如今需要技術團隊與新晉技術團隊能協作的知識平台。
- 文件因AI變得更以人為本：儘管AI代理將消耗多數文件流量，高品質、結構化內容的需求反而提升人類參與度。工程師現在直接承受過時文件導致的後果（故障的AI代理），因而更有動力維護文件；終端使用者則期待能以精緻對話式介面查詢文件。
- 最大客戶源自隨性且極度響應的支援：Mintlify部分頂級企業客戶始於週末社群Slack的隨性對話。創辦人近乎即時回應用戶的文化——與其最快AI實驗室客戶的步調同步，成為贏得企業信任與銷售的關鍵意外驅動力。
實踐啟示
- 尋找一位狂熱用戶勝過千名溫和使用者：極度聚焦解決單一問題，直到至少一人「熱愛」你的方案。真正欣喜用戶的直覺反應，是產品市場契合度的明確信號，而大量溫和回饋反而可能模糊此訊號。
- 以「展示勝於訴說」的原型構建於數日而非數週：當對問題有強烈直覺時，限時構建最簡原型。透過真實用戶獲取即時具體回饋——對潛在客戶而言，親眼所見往往比任何推銷更具說服力。
- 擁抱「做無法擴張之事」為核心哲學：手動引導用戶、編輯其內容或提供閃電般支援，不僅是成長策略，更是建立深厚客戶情感、揭示可擴張方案終極樣貌的基礎實踐。
- 為API優先設計，UI其次：當AI代理成為內容主要消費者，優先考慮數據層的結構、精確度與機器可讀性。精美介面雖重要，但若底層內容無法被人類與機器共同消化，則僅是表面裝飾。
- 讓最苛刻的客戶設定你的營運節奏：與極速步調的企業合作，將迫使你提升自身速度與標準。
採用他們對快速反應與迭代更新的期望——這種高節奏工作模式將轉化為強大的企業文化與競爭優勢，最終惠及所有客戶。
La propia naturaleza de la documentación está experimentando un cambio sísmico, transformándose de material de referencia estático escrito para humanos en una infraestructura dinámica y operativa consumida directamente por agentes de IA. Esta evolución crea una nueva necesidad urgente: cuando los agentes de programación y los bots de soporte dependen de la documentación como su fuente de verdad, las inexactitudes no solo confunden a los usuarios, sino que provocan fallos en los sistemas. Este cambio fundamental en la razón por la que la documentación importa está en el centro del recorrido de Mintlify, una empresa que comenzó queriendo simplemente mejorar la experiencia de los desarrolladores, pero terminó situándose en el centro de una revolución mucho mayor en la forma en que se crea y consume el conocimiento.
Los fundadores, Han Wang y Hanbi Li, llegaron a su producto actual solo después de “un año y medio vagando por el desierto” y ocho giros estratégicos distintos, todos centrados en ayudar a quienes construyen productos. Su gran avance no surgió de una visión grandiosa, sino de un prototipo pragmático creado en dos días para la startup de un amigo. El amor intenso e inmediato de los clientes por ese prototipo —en marcado contraste con la indiferencia cortés que habían recibido ante ideas anteriores— les confirmó que, por fin, habían encontrado un problema real. Esto les enseñó el valor del fracaso repetido: afina tu capacidad para reconocer un verdadero ajuste producto-mercado cuando finalmente tropiezas con él.
Hoy, el enfoque de Mintlify se ha ampliado de forma drástica. Aunque comenzó como una plataforma de documentación bellamente diseñada para desarrolladores, el auge de la IA ha convertido su contenido en una capa crítica de datos. La empresa ahora no solo da servicio a documentación pública de API, sino también a bases de conocimiento internas, centros de ayuda y wikis de RR. HH. Esta expansión está impulsada por una nueva realidad: a medida que personas no desarrolladoras usan herramientas de programación con IA y los equipos de ingeniería pasan a ser responsables de agentes de soporte impulsados por IA, la demanda de contenido preciso y legible por máquinas abarca a toda la organización. La intuición de producto está pasando de perfeccionar el aspecto visual de la documentación a garantizar que el contenido subyacente esté impecablemente estructurado y actualizado.
De cara al futuro, lo que más entusiasma a los fundadores es el creciente impacto de Mintlify en empoderar a quienes construyen a gran escala, así como los nuevos desafíos de crear agentes de IA capaces de mantener la documentación de forma autónoma. Prevén un mundo en el que la gran mayoría del tráfico de documentación provenga de la IA, pero subrayan que una interfaz orientada a humanos seguirá siendo crucial, no muy distinto de cómo los libros persisten en la era digital. Sin embargo, la misión central permanece intacta: reducir la fricción de convertir ideas en realidad, ya sea para una niña o niño de 11 años que está aprendiendo a programar o para una empresa del Fortune 10 que despliega una flota de agentes de IA.
Ideas sorprendentes
- La migración manual “no escalable” es una estrategia permanente: Al principio, los fundadores migraban manualmente la documentación de los clientes e incluso la editaban para mejorar la gramática y la estructura. Cuando les dijeron que ese proceso tan minucioso sería temporal, Paul Graham respondió que ese servicio práctico, de “ir un paso más allá”, sería para siempre su ventaja competitiva, una predicción que han comprobado que era cierta.
- La IA amplía el mercado al hacer que las personas no desarrolladoras sean más técnicas: El auge de los “vibe coders” y de quienes usan herramientas como Cursor significa que el lenguaje del desarrollo (Markdown, bloques de código) se está volviendo universal. Esto, de manera fortuita, convirtió la apuesta inicial de Mintlify centrada en desarrolladores en un viento de cola, ya que ahora empresas enteras necesitan una plataforma de conocimiento en la que puedan colaborar tanto equipos técnicos como equipos recientemente tecnificados.
- La documentación se está volviendo más centrada en el ser humano gracias a la IA: Aunque los agentes de IA consumirán la mayor parte del volumen de documentación, la necesidad de contenido de alta calidad y bien estructurado en realidad incrementa la participación humana. Los ingenieros ahora sienten las consecuencias directas de una documentación desactualizada (agentes de IA que fallan), lo que genera un incentivo más fuerte para mantenerla al día, y los usuarios finales esperan interfaces sofisticadas, similares a un chat, para consultar la documentación.
- Los clientes más grandes se ganan mediante un soporte informal e hiperrápido: Algunos de los mayores clientes empresariales de Mintlify comenzaron como conversaciones casuales en su comunidad de Slack durante un fin de semana. La cultura de los fundadores de responder casi instantáneamente a cualquier usuario, reflejando el ritmo de sus clientes más rápidos de laboratorios de IA, ha sido un impulsor clave e inesperado de la confianza empresarial y de las ventas.
Conclusiones prácticas
- Busca un usuario entusiasmado en lugar de mil tibios: Concéntrate intensamente en resolver un solo problema tan bien que al menos una persona ame tu solución. La reacción visceral de un usuario realmente encantado es una señal inconfundible de ajuste producto-mercado que una retroalimentación tibia de una multitud más grande puede ocultar.
- Construye un prototipo de “mostrar, no contar” en días, no en semanas: Cuando tengas una fuerte intuición sobre un problema, limita el tiempo de trabajo para construir el prototipo más simple posible. Úsalo para obtener comentarios inmediatos y concretos de un usuario real; a menudo, para un cliente potencial, ver es creer de una manera que un discurso comercial nunca puede lograr.
- Adopta “hacer cosas que no escalan” como una filosofía central: Incorporar usuarios manualmente, editar su contenido o proporcionar soporte ultrarrápido no son solo trucos de crecimiento; son prácticas fundamentales que generan un profundo aprecio del cliente y revelan con precisión qué debe ofrecer finalmente una solución escalable.
- Diseña primero para la API y después para la interfaz: A medida que los agentes de IA se convierten en los principales consumidores de contenido, prioriza la estructura, la precisión y la legibilidad automática de tu capa de datos. Una interfaz hermosa es importante, pero es solo decoración si el contenido subyacente no puede ser consumido tanto por humanos como por máquinas.
- Deja que tus clientes más exigentes marquen tu ritmo operativo: Trabajar con empresas que se mueven a gran velocidad te obliga a elevar tu propia rapidez y tus estándares.
Adopten sus expectativas de capacidad de respuesta e iteración: este alto ritmo se convierte en una poderosa cultura y una ventaja competitiva que beneficia a todos sus clientes.
A própria natureza da documentação está passando por uma mudança sísmica, transformando-se de material de referência estático, escrito para humanos, em uma infraestrutura dinâmica e operacional consumida diretamente por agentes de IA. Essa evolução cria um novo imperativo urgente: quando agentes de programação e bots de suporte dependem da documentação como sua fonte da verdade, imprecisões não apenas confundem usuários — elas fazem sistemas quebrarem. Essa mudança fundamental no motivo pelo qual a documentação importa está no centro da trajetória da Mintlify, uma empresa que começou querendo simplesmente melhorar a experiência do desenvolvedor, mas se viu no coração de uma revolução muito maior na forma como o conhecimento é criado e consumido.
Os fundadores, Han Wang e Hanbi Li, chegaram ao produto atual apenas depois de “um ano e meio vagando no deserto” e de oito pivôs distintos, todos centrados em ajudar criadores. O avanço decisivo não veio de uma grande visão, mas de um protótipo pragmático construído em dois dias para a startup de um amigo. O amor intenso e imediato dos clientes por aquele protótipo — em forte contraste com a indiferença educada que haviam recebido diante de ideias anteriores — confirmou que eles finalmente tinham encontrado um problema real. Isso lhes ensinou o valor do fracasso repetido: ele refina sua capacidade de reconhecer um verdadeiro encaixe entre produto e mercado quando, enfim, você tropeça nele.
Hoje, o foco da Mintlify se expandiu dramaticamente. Embora tenha começado como uma plataforma de documentação para desenvolvedores com um design elegante, a ascensão da IA transformou seu conteúdo em uma camada crítica de dados. A empresa agora atende não apenas documentação pública de APIs, mas também bases de conhecimento internas, centrais de ajuda e wikis de RH. Essa expansão é impulsionada por uma nova realidade: à medida que não desenvolvedores usam ferramentas de programação com IA e equipes de engenharia passam a ser responsáveis por agentes de suporte movidos por IA, a demanda por conteúdo preciso e legível por máquina se estende por toda a organização. A intuição de produto está mudando de aperfeiçoar a aparência da documentação para garantir que o conteúdo subjacente seja impecavelmente estruturado e esteja sempre atualizado.
Olhando para o futuro, o que mais entusiasma os fundadores é o impacto crescente da Mintlify em capacitar criadores em escala, bem como os novos desafios de construir agentes de IA capazes de manter documentação de forma autônoma. Eles preveem um mundo em que a vasta maioria do tráfego de documentação virá da IA, mas enfatizam que uma interface voltada para humanos continuará sendo crucial — não muito diferente de como os livros persistem na era digital. A missão central, porém, permanece inalterada: reduzir o atrito de transformar ideias em realidade, seja para uma criança de 11 anos aprendendo a programar ou para uma empresa da Fortune 10 implantando uma frota de agentes de IA.
Percepções Surpreendentes
- A migração manual “não escalável” é uma estratégia permanente: No início, os fundadores migravam manualmente a documentação dos clientes e até a editavam em termos de gramática e estrutura. Quando foram aconselhados de que esse processo minucioso seria temporário, Paul Graham rebateu dizendo que esse serviço prático, de “ir além do esperado”, seria para sempre sua vantagem competitiva — uma previsão que eles constataram ser verdadeira.
- A IA expande o mercado ao tornar não desenvolvedores mais técnicos: O aumento dos “vibe coders” e de pessoas usando ferramentas como Cursor significa que a linguagem do desenvolvimento (Markdown, blocos de código) está se tornando universal. Isso transformou de forma serendipidosa a aposta inicial da Mintlify, centrada em desenvolvedores, em um vento a favor, já que empresas inteiras agora precisam de uma plataforma de conhecimento na qual equipes técnicas e recém-técnicas possam colaborar.
- A documentação está se tornando mais centrada no humano por causa da IA: Embora agentes de IA consumam a maior parte do volume de documentação, a necessidade de conteúdo de alta qualidade e bem estruturado na verdade aumenta o engajamento humano. Engenheiros agora sentem as consequências diretas de documentação desatualizada (agentes de IA quebrados), o que cria um incentivo maior para mantê-la em dia, e usuários finais esperam interfaces sofisticadas, semelhantes a chat, para consultar a documentação.
- Os maiores clientes são conquistados por meio de suporte casual e extremamente responsivo: Alguns dos maiores logos corporativos da Mintlify começaram como conversas casuais em seu Slack comunitário durante um fim de semana. A cultura dos fundadores de responder quase instantaneamente a qualquer usuário, espelhando o ritmo de seus clientes mais rápidos de laboratórios de IA, tem sido um fator-chave e inesperado de confiança empresarial e vendas.
Aprendizados Práticos
- Busque um usuário eufórico em vez de mil usuários mornos: Foque intensamente em resolver um único problema tão bem que pelo menos uma pessoa ame sua solução. A reação visceral de um usuário genuinamente encantado é um sinal inequívoco de encaixe entre produto e mercado, algo que o feedback morno de uma multidão maior pode obscurecer.
- Construa um protótipo “mostre, não conte” em dias, não em semanas: Quando você tiver uma forte intuição sobre um problema, limite seu esforço no tempo para construir o protótipo mais simples possível. Use-o para obter feedback imediato e concreto de um usuário real — muitas vezes, para um potencial cliente, ver é acreditar de um jeito que um pitch jamais consegue igualar.
- Abrace “fazer coisas que não escalam” como uma filosofia central: Integrar usuários manualmente, editar seu conteúdo ou fornecer suporte extremamente rápido não são apenas truques de crescimento; são práticas fundamentais que constroem um amor profundo do cliente e revelam exatamente quais detalhes uma solução escalável precisará oferecer no fim das contas.
- Projete primeiro para a API, depois para a interface: À medida que agentes de IA se tornam os principais consumidores de conteúdo, priorize a estrutura, a precisão e a legibilidade por máquina da sua camada de dados. Uma interface bonita é importante, mas é apenas fachada se o conteúdo subjacente não puder ser consumido por humanos e máquinas.
- Deixe que seus clientes mais exigentes definam o seu ritmo operacional: Trabalhar com empresas que se movem em altíssima velocidade obriga você a elevar sua própria rapidez e seus próprios padrões.
Adote as expectativas deles em relação à capacidade de resposta e à iteração — esse ritmo acelerado se torna uma cultura poderosa e uma vantagem competitiva que beneficia todos os seus clientes.
Mintlify is a documentation platform built by cofounders Han Wang and Hahnbee Lee to help teams create and maintain developer docs. In this episode, Andreessen Horowitz general partners Jennifer Li and Yoko Li speak with Han and Hahnbee about how coding agents are changing what “good docs” mean, shifting documentation from a human-only resource into infrastructure that powers AI tools, support agents, and internal knowledge workflows. They share Mintlify’s early journey, including eight pivots, the two-day prototype that landed their first customer, and the “do things that don’t scale” sales motion that helped them win early traction. The conversation also covers why docs go out of date, what “self-healing” documentation requires to actually work, and how serving fast-moving customers has shaped both their product priorities and their pace.
Follow Jennifer Li on X: https://twitter.com/JenniferHli
Follow Yoko Li on X: https://twitter.com/stuffyokodraws
Follow Han Wang on X: https://twitter.com/handotdev
Follow Hahnbee Lee on X: https://twitter.com/hahnbeelee
Stay Updated:
Find a16z on X
Find a16z on LinkedIn
Listen to the a16z Show on Spotify
Listen to the a16z Show on Apple Podcasts
Follow our host: https://twitter.com/eriktorenberg
Please note that the content here is for informational purposes only; should NOT be taken as legal, business, tax, or investment advice or be used to evaluate any investment or security; and is not directed at any investors or potential investors in any a16z fund. a16z and its affiliates may maintain investments in the companies discussed. For more details please see a16z.com/disclosures.
Hosted by Simplecast, an AdsWizz company. See pcm.adswizz.com for information about our collection and use of personal data for advertising.
Leave a Reply
You must be logged in to post a comment.