Estudámos em profundidade mais de 2500 documentos de configuração de agentes e descobrimos que os documentos com melhor desempenho seguiam um padrão semelhante.

Primeiro, documentos práticos terão comandos executáveis diretamente na parte inicial, em vez de uma introdução longa. Assim, os desenvolvedores podem começar rapidamente, poupando o incômodo de folhear. Em segundo lugar, exemplos de código são sempre mais persuasivos do que descrições em texto - trechos de código reais podem ser compreendidos instantaneamente, enquanto explicações excessivas podem ter o efeito oposto.

A segurança da fronteira também é muito importante. Aqueles documentos que são bem feitos devem marcar claramente regras rígidas como "nunca submeter informações sensíveis", tranquilizando os desenvolvedores. Ao mesmo tempo, é necessário indicar claramente qual é a pilha tecnológica - os fatores de seleção devem ser evidentes para que se possa agir de forma direcionada.

Por fim, não podem faltar os seis principais domínios que cobrem o núcleo. A integridade desses elementos afeta diretamente o valor prático do documento e a experiência do usuário.