Use este modelo
Os artigos informativos são a base do marketing de conteúdos: educam, criam confiança e posicionam-se melhor nos motores de busca. Com a Trupeer, pode poupar horas na escrita de artigos informativos ao começar com um modelo gratuito, personalizá-lo com as suas diretrizes de marca e transformar cada artigo num resumo em vídeo que os leitores também podem ver.
Um artigo informativo explica algo. O que é, porque funciona da forma como funciona, qual é a diferença entre duas opções e o que acontece por trás de um processo.
São mais difíceis de escrever do que instruções e falham de formas diferentes. Um artigo “como fazer” falha quando alguém fica bloqueado. Uma explicação falha quando alguém termina a leitura, acredita que compreendeu e afinal não compreendeu.
Descarregue o modelo de artigo informativo
Formato | Melhor para |
|---|---|
Word (.docx) | Rascunhar e rever antes de publicar |
Explicações imprimíveis, documentos de briefing, folhetos | |
PowerPoint (.pptx) | Explicar um conceito numa sessão, em vez de num documento |
Google Docs | Rascunhar com um especialista no assunto |
Gratuito, editável, sem marca de água.
Que tipo de artigo precisa?
O leitor quer | Tipo | Modelo |
|---|---|---|
Compreender o que algo é ou porque funciona dessa forma | Informativo ou de conceito | Esta página |
Concluir uma tarefa específica | Como fazer | |
Tornar-se competente numa área completa | Guia | |
Procurar um valor ou opção exatos | Referência | |
Aprender do zero, acompanhando | Tutorial |
O erro estrutural mais comum na documentação é misturar estes formatos. Uma explicação com três passos “escondidos” no meio, ou um conjunto de instruções interrompido por contexto, não serve bem nenhum dos leitores.
Porque é que as explicações falham
Não porque o autor saiba pouco. Quase sempre é o contrário.
O leitor já acredita em algo. Chega com um modelo mental, geralmente incompleto e muitas vezes errado. Os factos adicionados a um modelo errado são absorvidos por ele, em vez de o substituírem. É por isso que alguém pode ler uma explicação rigorosa e continuar errado.
O autor esqueceu como é não saber. Quando compreende algo, a dificuldade de aprender torna-se invisível. Salta a etapa que o confundiu inicialmente porque já não parece uma etapa.
A abstração vem primeiro. Definições antes de exemplos é a ordem natural para quem já compreende e a ordem errada para toda a restante gente.
A completude é confundida com clareza. Cobrir todos os casos torna a explicação precisa, mas dificulta encontrar a ideia central.
Comece pelo que eles já acreditam
A coisa mais útil que pode fazer antes de escrever é descobrir o que o leitor pensa atualmente.
No caso de um conceito de produto, isso vem de tickets de suporte: as perguntas que as pessoas fazem revelam o modelo com que estão a operar. “Porque é que o meu relatório não atualizou” diz-lhe que a pessoa acha que atualiza em tempo real. Essa ideia errada é o que o seu artigo tem de abordar, e é mais útil do que qualquer quantidade de descrição rigorosa.
Depois, escreva a explicação para a desmontar, em vez de apenas descrever a verdade. São peças de escrita diferentes. Uma reconhece o que as pessoas assumem e mostra por que razão isso não se verifica. A outra afirma o que é verdade e espera que o leitor repare no conflito.
Nomear explicitamente a ideia errada funciona muito bem. “Pode esperar que o relatório atualize assim que os dados mudem. Não atualiza, e vale a pena compreender porquê.”
Como personalizar este modelo na Trupeer
Passo 1: Abra a secção Templates
Vá à secção Templates no menu principal.
Passo 2: Selecione e abra um modelo
Clique em qualquer modelo com que queira trabalhar para o abrir.
Passo 3: Expanda a vista do modelo
Se necessário, expanda a vista do modelo para ver o layout completo e os detalhes com clareza.
Passo 4: Edite o modelo
Clique em Edit para começar a modificar o modelo selecionado.
No editor, pode:
Adicionar novas secções
Definir ou atualizar regras de formatação
Adicionar um logótipo e ajustar a sua posição e definições relacionadas
Passo 5: Guarde o seu modelo personalizado
Depois de fazer todas as alterações necessárias, clique em Save para guardar o modelo atualizado como seu.
Passo 6: Pré-visualize e ajuste o modelo
Quando quiser ver como fica o seu modelo personalizado, abra o Preview.
A partir do ecrã de pré-visualização, pode continuar a fazer ajustes diretamente, se necessário, garantindo que o modelo aparece exatamente como o pretende.
Com um modelo de artigo informativo, pode:
Poupar horas na escrita: Ignore a página em branco com uma estrutura criada para conteúdos educativos.
Melhorar o SEO: Artigos bem estruturados posicionam-se melhor nos resultados de pesquisa.
Manter-se alinhado com a marca: Aplique o seu logótipo, fontes e cores usando o brand kit da Trupeer.
Envolver mais leitores: Combine artigos com resumos em vídeo para chegar a diferentes preferências de aprendizagem.
Uniformizar conteúdos: Use o mesmo modelo em publicações de blog e artigos da KB.
Atingir leitores globais: Traduza artigos para 65+ idiomas com um clique.
A estrutura da explicação
Secção | Objetivo |
|---|---|
Título | O que isto explica, pelas palavras do leitor |
A resposta curta | Duas ou três frases. Alguns leitores precisam apenas disto |
Porque é que isto importa para si | Que decisão ou problema isto afeta |
A suposição comum | O que as pessoas normalmente pensam, nomeado explicitamente |
A explicação real | Primeiro o concreto, depois o princípio geral |
Um exemplo | Um, desenvolvido |
Casos-limite e exceções | Depois de a ideia principal estar assente, não antes |
O que fazer com isto | A consequência prática |
Relacionado | Conceitos adjacentes e o “como fazer”, se existir |
A resposta curta no topo não é um resumo do artigo. É a resposta, para a parte substancial dos leitores que a quer e vai embora. Dar-lha imediatamente está correto. O artigo existe para os leitores que querem mais.
Do concreto para o abstrato
A melhoria mais fiável para qualquer explicação.
As pessoas compreendem um princípio geral muito mais facilmente depois de verem um exemplo específico. Escrever primeiro a definição e depois o exemplo inverte a forma como a compreensão se forma na prática. E é a ordem predefinida em quase toda a escrita técnica, porque é a ordem que parece lógica para quem já sabe.
Abstrato primeiro: O controlo de taxa limita o número de pedidos que um cliente pode fazer num intervalo de tempo definido, evitando a exaustão de recursos e garantindo a disponibilidade equitativa do serviço.
Concreto primeiro: Se enviar mais de 100 pedidos num minuto, começamos a rejeitá-los até o minuto terminar. Isto impede uma integração de consumir acidentalmente a capacidade de que todos os outros precisam. Essa restrição chama-se controlo de taxa.
A segunda opção não é mais simples em termos de conteúdo. Chega na ordem em que o leitor consegue absorver.
Analogias e onde elas falham
As analogias são a ferramenta mais poderosa na escrita explicativa e a que tem maior probabilidade de causar uma incompreensão subtil mais tarde.
Use uma quando o conceito é genuinamente desconhecido e existe um paralelo do dia a dia muito próximo. Mantenha-a curta e use-a uma vez, em vez de a estender ao longo do artigo.
Depois, diga onde é que ela deixa de funcionar. “Isto é um pouco como uma fila num balcão, exceto que, ao contrário de uma fila, a ordem não é garantida.” Nomear o limite impede que o leitor leve a analogia para um território onde ela produz conclusões erradas. É assim que as analogias criam as ideias erradas que os artigos posteriores têm de desfazer.
Se não consegue dizer onde é que a analogia falha, ainda não compreende o conceito o suficiente para o explicar.
O modelo do artigo
Campo | Introduza |
|---|---|
Título | O que isto explica |
Público-alvo | Para quem é e o que se assume que já sabe |
Resposta curta | Duas ou três frases |
Porque é importante | A decisão ou problema que isto afeta |
Suposição comum | O que as pessoas tipicamente acreditam |
Explicação | Exemplo concreto primeiro e depois o princípio |
Diagrama | Onde o conceito é estrutural ou sequencial |
Casos-limite | Depois da explicação principal |
Implicações práticas | O que fazer de forma diferente sabendo isto |
Artigos relacionados | Conceitos adjacentes e qualquer “como fazer” |
Responsável e última revisão |
Fraco e melhor
Abertura fraca: Este artigo fornece uma visão geral da nossa arquitetura de sincronização de dados e dos vários fatores que influenciam a frequência de atualização nos sistemas integrados.
Abertura melhor: Os seus dados atualizam a cada 15 minutos, não instantaneamente. Se acabou de alterar algo e não consegue vê-lo, é por isso. Explica como funciona a sincronização e quando é que a diferença importa.
Explicação fraca: O sistema utiliza um modelo de consistência eventual, em que as escritas são propagadas de forma assíncrona entre nós, sendo a convergência normalmente alcançada dentro de um intervalo de tempo limitado.
Explicação melhor: Quando guarda uma alteração, ela é escrita primeiro num local e copiada para os outros momentos depois. Durante alguns segundos, partes diferentes do sistema podem apresentar valores diferentes. Isto é intencional, porque esperar que cada cópia confirme antes de aceitar a sua alteração tornaria o processo de guardar muito mais lento. Importa numa situação: se guardar e executar imediatamente um relatório, o relatório pode não incluir a alteração.
Estrutura fraca: definição, história, arquitetura, casos de uso, exemplos.
Estrutura melhor: a resposta em uma linha, porque é que se deve importar, a incompreensão comum, um exemplo desenvolvido, depois a regra geral e, por fim, as exceções.
Extensão e âmbito
Um conceito por artigo. Se o título precisa de “e”, então tem dois.
A maioria dos artigos de conceito deve ser mais curta do que os autores gostariam. A tentação de cobrir todos os casos é maior aqui, porque o especialista no assunto consegue ver todas as exceções e cada uma parece importante.
O teste: alguém consegue ler isto e tomar a decisão que o artigo afeta? Se sim, a precisão adicional está a custar mais clareza do que está a comprar. Passe as exceções para um artigo de referência e crie ligações.
O intervalo razoável para a maioria dos textos explicativos é entre oitocentas e quinze centenas de palavras. Mais longo costuma significar vários conceitos ou um artigo de conceito que absorveu material de referência que pertence noutro lugar.
Diagramas
Os artigos de conceito beneficiam de diagramas mais do que qualquer outro tipo, porque grande parte do que explicam é estrutural ou sequencial.
Use um quando o conceito envolve coisas relacionadas com outras coisas, uma sequência de acontecimentos ou uma comparação entre dois estados. Um único diagrama de fluxo muitas vezes substitui quatro parágrafos.
Mantenha-o simples o suficiente para ser lido em poucos segundos. Um diagrama com vinte caixas não explica nada que vinte parágrafos não explicassem, e é mais difícil de atualizar.
Identifique tudo com as mesmas palavras que o artigo usa. Diagramas que introduzem a sua própria terminologia criam uma segunda coisa para aprender.
Quando explicar e quando criar ligações
Uma questão “em direto” na maior parte da documentação.
Explique no próprio texto quando o leitor não consegue avançar sem isso, quando são duas frases ou quando o objetivo total do artigo é esse conceito.
Crie ligações quando for um conceito genuíno por si só, quando apenas alguns leitores vão precisar disso ou quando a explicação duplicaria o comprimento.
Nunca explique no próprio texto num artigo “como fazer”. O leitor está a executar e o contexto interrompe. Crie ligações e mantenha os passos limpos. Esse é o argumento mais forte para existir artigos de conceito: dão aos artigos “como fazer” um sítio para enviar as pessoas.
Tipos de artigo informativo
Tipo | Respostas | Exemplo |
|---|---|---|
O que é | Definição e objetivo | O que é single sign-on |
Como funciona | Mecanismo | Como funciona a nossa sincronização |
Porquê | Racional de um design ou política | Porque é que os relatórios atualizam a cada 15 minutos |
Comparação | Diferença entre duas coisas | Planos standard versus premium |
Quando usar | Orientação para a decisão | Quando usar um workspace em vez de uma pasta |
Contexto | Contexto para uma alteração | Porque é que mudámos para o novo modelo de permissões |
Os artigos “porquê” são os mais valiosos e os menos escritos. A maior parte da documentação explica o quê e o como, deixando os leitores a adivinhar o racional. E as adivinhações são, normalmente, menos generosas do que a verdade.
Formatos
Word para rascunhar e rever, especialmente quando um especialista no assunto precisa de verificar a exatidão.
PDF para documentos de briefing, explicações impressas e tudo o que é distribuído em vez de publicado.
PowerPoint quando a explicação é apresentada como uma sessão. A explicação de conceito funciona muito bem ao vivo, porque pode ver as expressões e ajustar, o que um documento não consegue fazer.
O seu centro de ajuda ou base de conhecimento para tudo o que é voltado para o cliente, com ligações cruzadas a partir dos artigos “como fazer” que referenciam o conceito.
Testar uma explicação
É mais difícil de testar do que instruções, porque um leitor que compreendeu mal não sabe disso.
O método que funciona: peça a alguém para explicar de volta com as suas próprias palavras. Não se “compreendeu”, que toda a gente diz que sim. O que importa é a explicação em si. Onde a versão dessa pessoa diverge da sua é onde o artigo falhou.
Ainda melhor: peça para prever algo. “Tendo em conta o que acabou de ler, o que aconteceria se guardasse uma alteração e executasse imediatamente um relatório?” Uma previsão errada é um feedback preciso sobre qual parte não ficou.
Teste com alguém que corresponda ao público-alvo real. Um colega que já conhece o conceito vai ler o seu artigo e reconhecer a verdade nele, o que não lhe diz nada.
Manutenção
Os artigos de conceito envelhecem mais devagar do que os artigos “como fazer”, uma vez que os princípios subjacentes mudam menos frequentemente do que as interfaces.
Mas também podem dar errado de duas formas específicas. O sistema muda e a explicação deixa silenciosamente de ser verdadeira. Isto é pior do que um screenshot desatualizado, porque nada parece obviamente errado. E um artigo “como fazer” relacionado muda, deixando o artigo de conceito a descrever algo que as instruções já não correspondem.
Revise anualmente e sempre que a coisa que está a ser explicada mudar. Registe a data da última revisão, já que os leitores descontam razoavelmente as explicações de comportamento técnico sem data.
Boas práticas
Um conceito por artigo.
Resposta curta no topo, dada imediatamente.
Nomeie explicitamente a suposição comum.
Exemplo concreto antes do princípio geral.
No máximo uma analogia, com os seus limites declarados.
As exceções depois da ideia principal, nunca antes.
Um diagrama em que o conceito é estrutural.
Crie ligações em vez de explicar dentro de um artigo “como fazer”.
Teste pedindo a alguém para explicar de volta.
Diga o que fazer de forma diferente sabendo isto.
Erros comuns
Definição primeiro, exemplo por último.
Cobrir todas as exceções, enterrando a ideia central.
A crença existente do leitor nunca é abordada, por isso a correção não “assenta”.
Escrito para alguém que já compreende.
Uma analogia estendida para além do ponto em que se mantém válida.
Conceito e instruções misturados no mesmo artigo.
Sem implicação prática, por isso o leitor aprende algo e não faz nada com isso.
Jargão definido usando outro jargão.
Diagramas com a sua própria terminologia.
Testado com colegas que já sabiam.
Sem data, para que os leitores não consigam avaliar se ainda é verdade.
Algumas coisas são mais fáceis de mostrar do que de escrever
Abra o modelo na Trupeer AI, aplique o seu brand kit para que os artigos correspondam à sua documentação e edite qualquer secção diretamente. A configuração está no guia do modelo.
A escrita explicativa é genuinamente difícil e alguns conceitos resistem a isso. Qualquer coisa sequencial, qualquer coisa em que o leitor precise de ver a mudança de estado e qualquer coisa que envolva uma interface tende a exigir quatro parágrafos para escrever e trinta segundos para demonstrar.
Registe o que está a acontecer e a Trupeer AI produz a explicação escrita e um vídeo narrado a partir da mesma passagem. Assim, o artigo pode ter os dois. Os leitores que preferem texto ficam com o texto e os que precisam de ver também conseguem. Traduza-o para 65+ idiomas e mantenha o conjunto na sua base de conhecimento, ao lado dos artigos “como fazer” que para lá fazem ligações.
Registe. Dê marca. Traduza. Trupeer.
Perguntas Frequentes
Existe um modelo gratuito de artigo informativo em Word?
Sim. O Word é o formato principal, com a estrutura completa, incluindo as secções de resposta curta, suposição comum e explicação. Descarregamento gratuito, sem registo, sem marca de água.
Existe um modelo de artigo em Word, gratuito para descarregar?
Sim, e funciona para artigos explicativos de qualquer tipo: o que-é, como-funciona, porquê, comparações e peças de orientação para a decisão.
Existe um modelo gratuito de artigo?
Sim, no Word, PDF e PowerPoint, todos gratuitos e sem necessidade de conta. Se precisar de instruções em vez de explicação, o modelo de artigo “como fazer” é a opção mais adequada.
Existe um modelo gratuito de artigo informativo em PDF?
Sim, tanto em branco como com um exemplo preenchido, o que é útil porque a diferença entre uma boa e uma má explicação é mais fácil de ver do que de descrever.
Existe um modelo gratuito de artigo informativo em PPT ou PowerPoint?
Sim. A versão em PowerPoint é para explicar um conceito numa sessão, em vez de num documento. Muitas vezes funciona melhor, porque pode ver se as pessoas estão a acompanhar e ajustar. Mantenha a versão escrita como registo.
Posso descarregar um modelo gratuito de artigo informativo?
Sim, todos os formatos são descarregamentos gratuitos, sem necessidade de atribuição.
Qual é o melhor modelo gratuito de artigo informativo?
O que tem uma secção de resposta curta no topo e um espaço para nomear a ideia errada comum. A maioria dos modelos dá-lhe títulos para introdução, corpo e conclusão. É essa a estrutura que torna as explicações difíceis de seguir. Responder imediatamente e abordar o que o leitor já acredita são as duas coisas que mais melhoram uma explicação.
O que é um artigo informativo?
Um artigo que explica algo em vez de instruir alguém. Responde ao que é uma coisa, como funciona, porque funciona dessa forma ou como é que duas coisas diferem. Diferencia-se de um artigo “como fazer”, que orienta uma tarefa, e de material de referência, que lista valores e opções.
O que deve incluir um artigo informativo?
Um título pelas palavras do leitor, uma resposta curta de duas ou três frases, porque é que isso é importante para si, a suposição comum declarada explicitamente, a explicação com um exemplo concreto antes do princípio geral, os casos-limite depois, a implicação prática e ligações para conceitos relacionados e qualquer “como fazer” relevante.
Como se escreve uma boa explicação?
Descubra o que o leitor acredita atualmente, normalmente a partir de perguntas de suporte, e escreva para desmontar isso, em vez de apenas afirmar a verdade. Coloque o exemplo concreto antes do princípio abstrato. Dê a resposta curta imediatamente. Use no máximo uma analogia e diga onde é que ela falha. Coloque as exceções depois da ideia principal, não antes.
Quanto tempo deve ter um artigo informativo?
Oito centenas a quinze centenas de palavras para a maioria dos conceitos. Mais longo costuma significar que está a cobrir vários conceitos ou que absorveu material de referência que pertence noutro lugar. O teste é se o leitor consegue tomar a decisão que o artigo afeta, e não se todos os casos estão cobertos.
Qual é a diferença entre um artigo informativo e um artigo “como fazer”?
Um artigo informativo explica o porquê ou o quê. Um artigo “como fazer” explica como, em passos numerados, para alguém que está a meio da tarefa. Misturá-los não serve nenhum dos leitores: quem está a executar não quer contexto e quem está a aprender não quer ser “lançado” no passo quatro. Mantenha-os separados e crie ligações entre eles.
Como sabe se uma explicação resultou?
Peça a alguém para explicar de volta com as suas próprias palavras ou, melhor ainda, para prever o que aconteceria numa situação específica. Perguntar se “compreendeu” produz um sim, independentemente. Teste com alguém do público-alvo real, porque um colega que já conhece o conceito vai reconhecer a verdade no seu artigo sem aprender nada com ele.
Com que frequência devem ser revistos os artigos informativos?
Anualmente e sempre que a coisa que está a ser explicada mudar. Envelhecem mais devagar do que os artigos “como fazer”, mas falham de forma mais silenciosa: um screenshot desatualizado é óbvio; uma explicação que já não é verdadeira parece exatamente como uma que é.
Posso personalizar este modelo de artigo informativo?
Sim, todas as versões são totalmente editáveis. As duas secções que vale a pena manter são a resposta curta no topo e a suposição comum, porque são elas que distinguem uma explicação que as pessoas seguem de uma que apenas leem.
