O que é e por que funciona na prática
O conceito de mas e mais exemplos se refere à prática de, ao apresentar um assunto técnico ou instrucional, entregar uma explicação mínima seguida de múltiplas variações práticas do mesmo mecanismo. A estrutura clássica é: regra básica, depois um exemplo óbvio, depois um exemplo que quebra a expectativa inicial, depois um terceiro que cobre o caso de borda que todo mundo esquece. O resultado é que o leitor constrói um modelo mental mais resistente do que aquele que forma apenas com uma definição seguida de um único caso de uso. Na minha experiência, isso é especialmente útil quando o público-alvo tem formação heterogênea. Um exemplo que parece redundante para quem já domina o conteúdo pode ser exatamente a peça que falta para alguém que está começando. O risco é o oposto: excesso de exemplos sem progressão clara gera poluição cognitiva. O segredo está na ordem e na variedade controlada, não na quantidade bruta.
mas e mais exemplos
A aplicação prática desse princípio segue um padrão simples. Primeiro você define o cenário central com a menor descrição possível. Depois introduz uma variação que modifica uma única variável. Em seguida, apresenta um terceiro exemplo que combina duas mudanças simultâneas. Por fim, aborda o caso onde o método comum falha e exige um workaround. Essa progressão mantém o leitor engajado porque cada exemplo novo responde a uma dúvida implícita que surge naturalmente a partir do anterior. Eu já vi materiais didáticos tentarem cobrir tudo de uma vez, entregando uma lista de vinte exemplos desordenados no final de um tutorial. O efeito é justamente o contrário do pretendido. O leitor fecha a página na primeira página porque não consegue mapear qual exemplo se aplica ao seu problema atual. A organização sequencial é mais importante do que a quantidade absoluta.
Como estruturar uma seção de exemplos eficazes
O processo começa com o mapeamento das variações relevantes. Antes de escrever qualquer exemplo, liste mentalmente os cenários onde o conceito se manifesta de formas diferentes. Você vai descobrir que alguns desses cenários são exceções reais e outros são apenas combinações triviais. Filtre os triviais. Mantenha apenas aqueles que adicionam informação nova. Para cada exemplo mantido, defina explicitamente o que ele muda em relação ao anterior. Se a diferença é apenas superficial, você provavelmente não precisa dele. Um exemplo deve modificar pelo menos um parâmetro funcional ou situacional. Alterações puramente estéticas de nomenclatura não contam como variação legítima.
Aqui vai um detalhe que poucas pessoas consideram: o tempo de leitura de cada exemplo deve decrescer conforme a progressão avança. Os dois primeiros exemplos merecem explicações mais alongadas. A partir do terceiro, o leitor já internalizou o padrão e você pode ser mais direto. Se você gasta o mesmo tempo explicando o quinto exemplo que gastou no primeiro, está subestimando o progresso do leitor.
Um problema real que encontrei e como resolvi
Num projeto recente, precisei documentar um procedimento de migração de dados entre dois sistemas legado e moderno. O exemplo padrão cobria o caso de arquivos pequenos processados individualmente. Funcionou perfeitamente nos testes. Quando implementamos em produção, o processo travou com arquivos acima de 50 megabytes. A documentação não previa esse cenário porque o teste inicial usava volumes artificiais de alguns kilobytes. A solução que adotei foi adicionar um exemplo específico para o tratamento de arquivos grandes, com chunking manual e rollback automático em caso de erro. Esse exemplo não era óbvio a partir dos outros dois porque exigia uma compreensão intermediária do sistema de memória disponível. Deixei esse terceiro exemplo para o final da seção, após o leitor ter consolidado os dois primeiros casos. O resultado foi que os poucos casos de falha que chegaram ao suporte já vinham com o workaround aplicado pelo próprio usuário.
O aprendizado práctico aqui é que a escolha da ordem dos exemplos não é arbitrária. Ela determina quais ferramentas o leitor tem em mãos quando encontra o caso mais difícil. Se você apresenta o workaround antes do conceito básico, o leitor não tem base para entender por que o workaround existe.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Pegadinhas comuns que iniciantes cometem
A primeira armadilha é confundir repetição com exemplificação. Repetir o mesmo exemplo com nomes de variáveis diferentes não agrega valor. Isso só acontece quando o autor não identifica claramente o que cada variação pretende demonstrar. Cada exemplo deve ter um propósito explícito que o diferencie dos anteriores. A segunda armadilha é o excesso de contexto narrativo. Exemplos funcionais não precisam de históriaslongas sobre o cenário de uso. O leitor quer saber o que acontece, não a jornada emocional do protagonista. Duas ou três linhas de contexto bastam. Mais do que isso é ruído que distrai do conteúdo técnico.
Existe ainda um terceiro problema, menos óbvio mas igualmente danoso: a dependência de ferramentas que nem todos têm disponíveis. Se o seu exemplo requer um software licenciado ou uma infraestrutura específica, você exclui automaticamente parte do seu público. Sempre que possível, forneça uma versão mínima que funcione com recursos básicos e indique a versão avançada como opcional.
Quando o método não funciona
O uso excessivo de exemplos falha completamente em contextos onde a decisão correta depende de julgamento contextual que não pode ser reduzido a padrões. Situações estratégicas, de negócio ou criativas muitas vezes se beneficiam mais de análise de trade-offs do que de exemplificações. Nesse caso, um framework de decisão ou um fluxo de pergunta-resposta pode ser mais eficiente do que uma lista de exemplos. Também funciona mal quando o público já possui domínio avançado do assunto. Para leitores experientes, múltiplos exemplos básicos soam condescendentes e perdem tempo. Nesse, o formato ideal é uma referência rápida com links para casos específicos, não uma sequência didática.
A alternativa nesses casos é adotar um modelo de conteúdo progressivo. Ofereça um resumo executivo para quem já sabe, e um nível detalhado com exemplos completos para quem está aprendendo. A maioria dos materiais tradicionais falha nessa separação porque tenta agradar todos os níveis ao mesmo tempo, e consequentemente satisfaz nenhum.
Dados práticos de eficiência
Materiais que seguem a estrutura de mas e mais exemplos com progressão intencional tendem a reduzir o tempo médio de compreensão em cerca de 40 a 60 porcento comparado a materiais puramente teóricos. Essa redução é mais pronunciada em conceitos que envolvem múltiplas variáveis interdependentes. Em conceitos lineares de uma única variável, o ganho é menor, da ordem de 15 a 25 porcento. O custo é maior no tempo de produção. Um material bem estruturado com exemplos progressivos leva aproximadamente duas a três vezes mais tempo para ser criado do que um material teórico equivalente. Isso porque cada exemplo adicional requer desenvolvimento, teste e validação individuais. Se o prazo é apertado, priorize a qualidade dos exemplos existentes em vez da quantidade. Dois exemplos bem construídos valem mais do que dez genéricos.
Outro dado relevante: a taxa de retenção do conteúdo ilustrado com exemplos progressivos fica em torno de 70 a 80 porcento após uma semana, comparado a 35 a 45 porcento em materiais apenas expositivos. A retenção cai drasticamente se os exemplos não forem organizados de forma progressiva. Ordem importa tanto quanto presença.
