No meu último emprego, a nossa documentação era terrível, então decidimos reformulá-la. Este foi um processo que envolveu dezenas de pessoas, incluindo vários PMs, inúmeras reuniões, mais de mil horas de tempo de engenharia/design e, se eu tivesse que estimar, dez mil horas-pessoa. Implorei a todos os envolvidos para usarem @mintlify durante todo o processo, que incluiu semanas para identificar um fornecedor adequado. Ninguém me ouviu. Depois que toda essa reformulação foi concluída, a documentação estava: >esteticamente pouco atraente >dificil de manter, >com uma busca terrível >e sem chat de IA >com branding inconsistente >sem llms.txt >com flashes estranhos ao navegar pelas páginas >completamente não otimizada para SEO >extremamente difícil de indexar por LLMs E o pior de tudo: quaisquer mudanças grandes ainda requerem múltiplos stakeholders e semanas para serem implementadas. Para ser justo, esta empresa tinha alguma da documentação mais técnica e extensa do mundo, abrangendo dezenas de produtos. Mas mudar para o Mintlify provavelmente teria proporcionado dezenas de milhões em valor ao longo de vários anos para um produto voltado para desenvolvedores. É por isso que estou tão otimista em relação ao Mintlify. Claro, eles facilitam para as empresas construírem documentação. Isso é ótimo. Mas o verdadeiro valor é que, à medida que essas empresas crescem e sua documentação inevitavelmente se torna mais sofisticada, elas precisarão de uma base sólida para construir. E não há base mais sólida para a sua documentação do que o Mintlify. ...