Lors de mon dernier emploi, notre documentation était terrible, donc nous avons décidé de la réorganiser. C'était un processus qui a impliqué des dizaines de personnes, y compris plusieurs chefs de projet, d'innombrables réunions, plus de mille heures de temps d'ingénierie/design et, si je devais estimer, dix mille heures-personnes. J'ai supplié tous les participants d'utiliser @mintlify tout au long du processus, qui a inclus des semaines pour identifier un fournisseur approprié. Personne ne m'a écouté. Après que toute cette réorganisation a été complétée, les docs étaient : >esthétiquement peu attrayants >difficiles à maintenir, >avaient une recherche terrible >et pas de chat AI >branding incohérent >pas de llms.txt >des flashes étranges lors de la navigation sur les pages >complètement non optimisés pour le SEO >extrêmement difficiles à indexer par les LLMs Et le pire de tout : tout changement important nécessite encore plusieurs parties prenantes et des semaines pour être mis en œuvre. Pour être juste, cette entreprise avait certaines des documentations les plus techniques et étendues au monde, couvrant des dizaines de produits. Mais passer à Mintlify aurait probablement apporté des dizaines de millions de valeur sur plusieurs années pour un produit orienté développeur. C'est pourquoi je suis si enthousiaste à propos de Mintlify. Bien sûr, ils facilitent la tâche des entreprises pour élaborer de la documentation. C'est super. Mais la véritable valeur est qu'à mesure que ces entreprises grandissent et que leur documentation devient inévitablement plus sophistiquée, elles auront besoin d'une base solide sur laquelle s'appuyer. Et il n'y a pas de base plus solide pour vos docs que Mintlify. ...