No desenvolvimento de software, coletamos antipadrões para reconhecer características comuns que levam a resultados ruins. Pensei que seria útil fazer o mesmo para blogs de software, então cataloguei os erros mais frequentes que vejo em blogueiros iniciantes.
O erro mais comum é divagar. Os desenvolvedores adoram especificidade, então começam as postagens do blog com histórias de fundo e contexto histórico. Isso pode ser divertido de escrever, mas nem sempre é interessante de ler. Da perspectiva do leitor, existem bilhões de outros artigos que eles poderiam estar lendo. Dê a si mesmo o título e as primeiras três frases para responder: O autor escreveu isso para alguém como eu? Como vou me beneficiar ao ler isso?
Alguns blogueiros escrevem uma introdução convincente, mas sobrecarregam o caminho do leitor com extras como um subtítulo, uma biografia ou uma imagem. Tudo o que você coloca no caminho do leitor consome seu suprimento finito de foco. Professores eficazes comparam novos conceitos a algo familiar ao leitor. Por exemplo, se você estivesse explicando Jellyfin, poderia dizer: "Jellyfin é um serviço de streaming como Netflix, exceto que é open-source e privado." Minimize suas suposições sobre o leitor.
Quando você escreve uma postagem de blog, pense no seu leitor-alvo. O que eles sabem? Imagine um amigo ou colega de equipe que você conhece na vida real. Escreva uma lista de termos que eles reconheceriam e termos que não reconheceriam.
Fonte: Hacker News · Resumido por HeadlinesBriefing