As empresas estão perdendo não escrevendo documentos para a IA, diz o CTO

O banco de dados de webinars gravados em tela pode estar saindo.

Laura Tacho, CTO da plataforma de produtividade do desenvolvedor DX, diz que as empresas devem pelo menos considerar a reescrita de seus documentos para torná -los mais legíveis para a IA.

A documentação corporativa geralmente é uma neblina bagunçada de memorandos, decks de slides e treinamentos de vídeo. Na era da IA, Tacho disse ao Business Insider que os materiais de treinamento deveriam estar em forma de texto, para que possam ser facilmente lidos por um grande modelo de idioma.

Os procedimentos baseados em texto são ainda mais importantes para os desenvolvedores, que podem alimentar imediatamente sua documentação a uma IA Editor de código como cursor.

Tacho disse que acha que os documentos podem beneficiar humanos e LLMs. Falando sobre o tópico sobre o “engenheiro pragmático” Podcast, ela disse que as empresas “AI-primeiro” estavam revisando sua documentação interna para o consumo de LLM.

“Essa tem sido a maior maneira que eu vi as empresas pensarem ou já começaram a tentar mudar a maneira como arquitetam seus serviços”, disse Tacho ao apresentador do Podcast, Gergely Orosz.

Em uma entrevista de acompanhamento à BI, Tacho elaborou sua política para documentação. Procedimentos bem organizados e baseados em texto não apenas ajudam um LLM ou um trabalhador humano, disse ela. O “Diagrama de Venn é um círculo”, disse ela.

“A documentação é um grande ponto de atrito para quase todas as organizações”, disse Tacho ao BI. “Há muito ganho de eficiência a ser obtido quando a documentação é mais adequada ao objetivo. Esta é uma área em que o que é bom para o humano também é bom para o LLM”.

A documentação humana-primeiro geralmente depende de “pistas visuais” e capturas de tela, que a IA pode encontrar incompreensível, disse Tacho. Ela recomendou que todas as fotos tivessem descrições de texto ao lado delas.

Os sites de mídia social geralmente têm textos alternativos e legendas para tornar seus serviços menos visuais exclusivamente. Tacho disse que os fabricantes de documentos corporativos podem “receber uma nota do mundo da acessibilidade da web”.

“É tão importante para as pessoas que não estão usando os olhos para acessar a tela”, disse ela.

Ela disse que outras tarefas, como centralização de documentos, ajudam a facilidade de acesso de um LLM e também facilitam a vida do trabalhador humano. Tacho usou o termo do desenvolvedor, dizendo que as empresas deveriam “desviar” suas políticas.

“A documentação é feita aos poucos, um pouco aqui, um pouco ali”, disse ela. “Você precisa pular entre páginas diferentes para reunir as instruções completas do que você deve fazer”.

Tacho também listou alguns elementos técnicos da documentação, como garantir que a marcação HTML seja semântica, o que pode ajudar a garantir a legibilidade do LLM.

Algumas empresas já começaram a mudança. Em maio, o ex -vice -presidente de desenvolvedor de Vercel, Lee Robinson, postou sobre a documentação da empresa em x.

“Estamos começando a adicionar comandos Curl à documentação de Vercel onde quer que dissessemos anteriormente ‘Clique'”, escreveu Robinson. “No futuro, talvez o computador usando agentes possa fazer login e executar ações para você, mas isso parece uma boa etapa incremental para os LLMs”.

A Tacho espera que mais empresas se juntem à Vercel para tornar seus documentos facilmente legíveis à IA. Ela descobriu que os engenheiros estavam desperdiçando mais de 30 minutos por semana procurando informações que não conseguiram encontrar na documentação. Os editores de código da IA devem automatizar esses problemas – se o LLM puder ler os documentos corretamente.

“Quando você pensa em quanto tempo está sendo desperdiçado devido a uma documentação ruim, isso se torna realmente um problema de negócios muito crítico”, disse ela.