Como criar um guia de estilo

Um guia de estilo resolve as pequenas dúvidas que, de outra forma, geram discussões a cada revisão: se é email ou e-mail, se os títulos usam maiúsculas apenas na primeira palavra (sentence case), como se referir aos clientes, quais palavras a empresa evita. Sem ele, cada redator segue seus próprios hábitos, e os revisores corrigem as mesmas coisas repetidamente.

Esta página aborda um guia de estilo de redação e conteúdo, do tipo que rege a voz, gramática, terminologia e formatação. Ela explica como as equipes costumam estruturar um guia, onde eles costumam ficar desatualizados e como criar um no Fabric a partir dos seus próprios exemplos e mantê-lo em uso, inclusive pelas ferramentas de IA com as quais sua equipe escreve.

Como as equipes costumam criar e manter um guia de estilo

A maioria dos guias de estilo começa como um documento no Google Docs ou arquivo do Word que uma pessoa escreve ao longo de alguns finais de semana. É rápido para começar e fácil de compartilhar. Conforme passa de vinte páginas, fica difícil de pesquisar, as pessoas guardam cópias locais e não fica claro qual versão é a atual.

Migrá-lo para uma wiki como Confluence ou Notion facilita encontrá-lo e vinculá-lo. A queixa mais comum é a manutenção: wikis ficam desatualizadas, a menos que alguém seja responsável por elas, e novas regras combinadas em uma reunião ou em um chat muitas vezes nunca chegam a ser incluídas. A governança de conteúdo cobre a parte de atribuição de responsabilidades.

Equipes de conteúdo maiores às vezes adotam um guia publicado, como o manual da AP ou de Chicago, e escrevem um breve suplemento interno como complemento. Outras pagam por ferramentas de escrita que comparam os textos com suas regras. Ambas as opções funcionam, embora as regras internas ainda precisem ser registradas em algum lugar primeiro, e os exemplos que as explicam geralmente estejam espalhados por documentos antigos.

Etapa 1: Reúna exemplos da sua melhor escrita

Um guia de estilo é muito mais fácil de escrever quando você pode apontar para exemplos reais. Crie uma pasta para o projeto e reúna textos que sua equipe considera bons: artigos de blog fortes, uma proposta bem-aceita, um texto de produto com bom desempenho nos testes, um e-mail que teve boa resposta dos clientes. Arraste arquivos para dentro, faça o upload ou cole textos e links diretamente no Fabric.

Adicione também exemplos externos. Com a extensão do navegador para Chrome, Safari e Firefox, salve páginas ou trechos de texto selecionados de outras empresas cujo tom você admira, além de uma captura de tela da página se o layout for importante. Adicione um comentário a cada item dizendo o que você gosta nele, para que o motivo fique registrado junto ao exemplo.

Etapa 2: Peça para a IA rascunhar os padrões encontrados

Abra a pasta de exemplos e pergunte ao assistente de IA. Ele se limita àquela pasta, para que você possa fazer perguntas como “qual tom essas peças têm em comum?”, “como formatamos títulos e listas?” ou “quais termos de produto aparecem e como estão capitalizados?”. As respostas citam os documentos de onde vieram, permitindo verificar cada padrão na fonte.

Salve as respostas úteis como notas. Elas formam o primeiro rascunho de cada seção: voz e tom, gramática e pontuação, terminologia, formatação e linguagem inclusiva. Você pode escolher qual modelo usar, já que uma única assinatura inclui modelos de vários dos principais laboratórios.

Etapa 3: Escreva o guia como um documento vivo único

Crie um documento no editor de notas e documentos e transforme os rascunhos no guia. Mantenha cada regra curta, acompanhada de um exemplo de "o que fazer" e "o que não fazer". Onde uma ilustração mais longa ajudar, vincule ao exemplo de origem na sua pasta ou incorpore-o ao guia.

Convide como editores as pessoas que devem moldá-lo. A edição acontece em tempo real, e outras ferramentas de colaboração, como comentários e menções, são ideais para as discussões que os guias de estilo costumam suscitar. O assistente de IA também pode editar o documento diretamente, com opção de aceitar ou rejeitar cada alteração, o que ajuda quando você deseja aprimorar a redação em todo o guia.

Se estiver criando vários documentos de referência para a equipe, a seção Criando uma biblioteca de modelos aborda maneiras de mantê-los consistentes.

Etapa 4: Compartilhe com a equipe e redatores externos

Compartilhe o guia com toda a equipe. Dê à maioria das pessoas acesso de visualização ou comentário e restrinja a edição a alguns poucos responsáveis; funções e permissões podem ser definidas no nível de espaço e de arquivo. Quem tem acesso de comentarista pode destacar uma linha e sugerir uma alteração, e os responsáveis marcam cada comentário como concluído após resolvê-lo.

Freelancers e agências também precisam do guia, geralmente sem acesso a nada além dele. Publique o guia como uma página web: clique em Compartilhar, abra a aba Publicar e clique em Criar link. Desative a indexação por mecanismos de busca se o guia for interno. As edições feitas no documento no Fabric atualizam a página publicada, portanto, o link enviado no ano passado ainda mostrará as regras atuais.

Etapa 5: Disponibilize o guia para ferramentas de escrita com IA

Muitos primeiros rascunhos agora começam no ChatGPT ou no Claude. Conecte essas ferramentas ao Fabric por meio do servidor MCP do Fabric em https://mcp.api.fabric.so/mcp. O login é feito via OAuth, sem chaves de API, e a configuração leva menos de um minuto. No Claude, adicione o Fabric a partir do diretório oficial de conectores. No ChatGPT, abra Configurações, vá em Conectores, escolha Adicionar Conector, insira a URL do servidor, dê um nome a ele e salve; em seguida, inicie uma nova conversa, clique em Mais, escolha Adicionar Conectores, selecione o Fabric e faça login quando solicitado.

Uma vez conectado, a ferramenta de IA pode pesquisar no Fabric e ler o conteúdo dos arquivos, permitindo que o redator solicite que ela siga o guia de estilo interno durante a redação. No plano Team, o Fabric Tag permite que as pessoas façam perguntas como “escrevemos a longo prazo ou em longo prazo?” mencionando o Fabric no Slack ou Discord.

Para uma abordagem mais ampla de materiais de referência para a equipe, consulte Como criar uma base de conhecimento compartilhada.

Perguntas frequentes

O que um guia de estilo de redação deve incluir?

A maioria aborda voz e tom, gramática e pontuação, terminologia e nomes de produtos, formatações como títulos e listas, além de linguagem inclusiva, cada um com exemplos curtos.

Qual deve ser o tamanho de um guia de estilo?

Não há um tamanho fixo. Muitas equipes começam com algumas páginas que abordam as dúvidas que mais surgem nas revisões e, em seguida, adicionam regras à medida que novas questões aparecem.

Devemos basear nosso guia de estilo no AP ou em Chicago?

Muitas equipes adotam um guia publicado como padrão e escrevem um pequeno guia interno para as exceções e termos específicos da empresa.

Como mantenho um guia de estilo atualizado?

Mantenha-o como um documento compartilhado único, com alguns responsáveis definidos. Os comentaristas sugerem alterações, os responsáveis as marcam como concluídas e um link publicado exibe a versão atual.

A IA pode ajudar a escrever um guia de estilo?

Sim. O assistente de IA do Fabric pode analisar uma pasta com seus textos existentes, descrever os padrões que encontrar com fontes citadas e editar o rascunho com a opção de aceitar ou rejeitar cada alteração.

Como faço para o ChatGPT ou o Claude seguir nosso guia de estilo?

Conecte a ferramenta ao Fabric usando o servidor MCP. Ela poderá então ler o conteúdo do guia quando você pedir para escrever no estilo da sua empresa.

Como compartilho um guia de estilo com freelancers?

Publique-o como um link. Os links publicados são apenas para visualização, e as edições feitas no Fabric atualizam a página que eles veem.

Quanto isso custa?

Notas e publicação estão no plano gratuito com uso limitado de IA. O Fabric Tag requer o plano Team, e o preço para equipes não é cobrado por usuário. Consulte os preços para equipes.