Escolar Documentos
Profissional Documentos
Cultura Documentos
STEPHANIE MORILLO
Traduzido por
RAY CARNEIRO
Introdução 4
Reconhecimentos 120
está motivado para criar, mas não sabe como manter suas ideias fluindo.
estão incluídos em várias seções (todos em inglês). Com este livro, você
aprenderá como:
seu conteúdo
pode não ser o único guia que você precisará para se tornar um guru de
frente ao seu computador com sua lista de ideias, pronto para começar a
recursos para o próximo nível, alguns dos quais estão listados na seção
de conteúdo.
valor ao leitor.
formas de conteúdo.
Este livro ensinará você como organizar suas ideias e criar planos
1.Brainstorming e planejamento
2.Elaboração
3.Edição
4.Refinamento
5.Promoção
que desejar.
uma vez por trimestre, com base na frequência com que você publica
coisas novas).
grande parte deste livro - porque é o meio que funciona melhor para
podcast.
***
mesmo uma mistura de ambos). Por exemplo, você pode blogar para:
Note que seu objetivo pode mudar. Mas, desde que você tenha um
escrevo muito sobre outras coisas. Onde eu deveria colocar esse tipo de
coisas?”
objetivo.
Cenário:
detalhes aqui podem não ser relevantes para você. Mas definir os
Seu público-alvo tem um problema específico que você não tem. O que
você tem é a solução. Talvez você já esteve na posição em que eles estão
perguntas:
novas ideias.
problema que você suspeita que outros possam ter. Se você criou um
sobre ela!
tópicos que eram mais relevantes para elas. Isso incluía coisas como:
• Cultura remota
• Gestão de Comunidades
• Engenharia de rede
• Treinamentos
postagem no blog não precisam ser grandiosas para fornecer valor e não
ideias que parecem "chatas" para você têm um tópico que as torna
• Design de interação
• Sistemas de design
• Arquitetura de informação
• Pesquisa de usuário
remoto
muito bem. Isso deve ser relevante de alguma forma para o assunto
sobre o qual você escreverá no seu blog. Quando você terminar sua lista,
que seria um ótimo post no blog. A maior parte da conversa foi sobre o
em seu blog;
um tutorial em vídeo;
está escrevendo.
Você tem um blog antigo que não acompanha há anos? Você tem
Existe um tópico recente que mexeu com você sobre o qual você pode
maneira de descobrir sobre o que mais você pode escrever é ouvir o que
estão apenas alguns lugares onde você pode encontrar novas ideias:
***
não precisa de muitos seguidores para serem úteis. Você pode fazer uma
Twitter, já viu isso antes. As pesquisas podem ajudar você a decidir entre
relacionados ao SSL.
Onde você estava preso? Como você conseguiu quebrar algo que
uma lista com pelo menos três coisas que você realmente quer aprender.
anteriormente?
• Existe algum aspecto dessa ideia que ainda não foi explorado?
lista.
sobre as quais você quer fazer uma pesquisa mais exploratória. Depois
ou “Não” para cada ideia. Nessa última coluna, coloque uma marcação
na caixa que você acredita ser uma boa escolha para sua ideia. Após
seguir.
Docs
ministrei.
Então aqui está o seu dever de casa: escreva todas as suas ideias e
não risque nenhuma da lista, não importa o quanto você esteja disposto
a riscá-la.
outro.
diferente do que você criaria para alguém que acompanha seu blog há
muito tempo.
Não se preocupe; isso não significa que estou pedindo para você
conteúdo brilhar.
marketing):
postagens no blog!)
lista!
leitor.
ajudá-los.
não devem ser postagens pessoais sobre você. A pergunta "Por que o
mente.
o projeto/produto
perguntas ou comentários
status como:
• Em andamento (pesquisa)
• Em andamento (redação)
• Em andamento (edição)
• Bloqueado
• Programado
• Publicado / Concluído
de conteúdo incluem:
• Um quadro Kanban
• Uma planilha
que você escolha um formato no qual possa se ater... e fique com ele!
inventário de ideias que você usou para criar sua lista de ideias do blog.
Priorize três ideias nessa lista na ordem em que você deseja publicá-las.
A plataforma certa para você é aquela que você pode manter com
Autogerenciado e Auto-hospedado
dois mundos. Você pode gerenciar seu conteúdo por meio de uma
• Ghost CMS
• Netlify CMS
• Contentful
• Kirby CMS
• Craft CMS
lidar com APIs, os geradores de sites estáticos são outra opção. Muitos
gratuitos (ou pagos) para você escolher. A primeira iteração do meu site
meu gosto.
• GatsbyJS
• Hugo
• Jekyll
• Middleman
você ficar sem espaço, precisará fazer o upgrade. Além disso, você é
você, GitHub Pages, Netlify, Heroku, Zeit e Surge são algumas opções a
serem consideradas.
Hospedagem gerenciada
pagar por uma assinatura, terá mais controle sobre a aparência do seu
site, no qual poderá remover a marca. Além disso, você poderá usar o
Aqui estão alguns construtores de sites sem código que vêm com
soltar:
• Webflow
• Wix.com
• Squarespace
essa seção pode ser uma ótima maneira de obter feedback, identificar
devem ser seu único canal de conteúdo. Você deve ter um site ou blog
pessoal que sirva como "seu cartão de visitas na web". Se você observar
várias plataformas:
• Medium
• Twitch
• Dev.to
• GitLab
• Dev.to
• YouTube
você deve manter sua presença nas plataformas que fazem sentido para
você. Ainda assim, você precisa de um espaço exclusivo que reforce sua
Tumblr?), pense em migrar esse conteúdo para outro lugar. Exclua contas
uma breve biografia e uma lista de links para outras plataformas nas
pessoal para você, no mínimo com uma breve biografia e links para perfis
entanto, fazer isso (por exemplo, publicar três vídeos em seu canal do
entre suas postagens faz com que você corra o risco de não ter conteúdo
portanto, seja paciente. Você não precisa publicar uma nova postagem
objetivo era publicar duas novas postagens por mês nos primeiros três
trabalho). Para publicar duas postagens por mês, eu precisava ter cerca
antemão e sabia que tinha apenas duas opções: atingir ou superar meus
objetivos. Publicar menos do que minha meta não era uma opção.
sustentável.
***
ambiciosas para nós mesmos: "Escreverei três novos posts por semana!"
Você deve publicar uma vez por semana, duas vezes por semana ou
duas semanas. Queria algo que me desafi asse a publicar mais do que
alguns meses, mas não tão ambicioso que não pudesse cumprir meu
conteúdo regularmente.
Criando um resumo
preparado e abre seu editor de texto apenas para descobrir que não
que explica sobre o que é a sua postagem, qual o valor que ela traz ao
posteriormente.
inclui o seguinte:
ajustar essas informações mais tarde, mas isso ajudará você a começar.
de seus tutoriais.
não está escrevendo um tutorial, seu esboço pode ser algo como isso:
aos usuários como fazer algo passo a passo, você deve descrever cada
encontrar um guia que deixe de fora um passo, pois assume que o leitor
completamente limpa para garantir que você não perdeu predefi nições
Figura 3: O esboço inicial original do livro que escrevi no aplicativo Notes do meu
Promoção.
mente o seguinte:
• Mantenha uma ação por etapa. Não adicione várias ações em uma
por:
• Palavras-chave
• Títulos de seção
Viu o que eu fiz ali? Os usuários não gostam de ler blocos de texto
poderá confundir os leitores que não sabem que esses dois são a
principal.
postagem.
cliquem.
está sublinhado.)
atualizações do RubyGems.”
sucesso:
disperse-as por toda parte. Não há fórmula para isto; se você for
visual, como eu, precisará deixar seus olhos ser seu guia. Eu gosto
de colocar uma imagem após cada terceiro parágrafo para dar aos
distribuídas adequadamente.
fi nal.
Você está escrevendo uma postagem que requer que você formate
Você não consegue formatar blocos de código como texto no seu site?
alguns tipos de tecnologia assistida podem apenas ler texto. Como você
Você já usou algum tutorial para aprender uma estrutura que nunca
• “É fácil montar”
• “A resposta é óbvia”
técnico usam essas palavras para fazer com que o assunto pareça menos
seus usuários, mas estão usando uma linguagem que faz com que o
difícil! Precisa ser refeito”. Outros podem pensar: “Isso é fácil? Devo ser
o são.
relativos. O que me parece fácil pode ser um desafio para outra pessoa.
Nosso objetivo é remover o atrito. Seu trabalho deve ser claro, a fim de
que exige que os leitores prestem muita atenção para conseguir algo, vá
presuma que seu público saberá o que você quer que eles façam a
escrita. Ele destaca seções confusas, áreas que são muito longas e
muito mais.
realizar uma pesquisa, mas não ficou claro quais opções incluir, use
esteja concluído.
capítulo, volte a ela mais tarde. A coisa mais importante que você pode
Boa sorte!
post. Você também está confiante de que tem algo valioso para
rapidamente
post
esperar mais alguns dias até que sua postagem esteja polida e pronta
da compreensão do leitor.
necessárias para realizar o que o escritor diz que o leitor poderá fazer?
será capaz de entender esta frase? Existem áreas supérfluas e que não
editar.
link”?
gramaticais. Leia sua postagem em voz alta para ter uma noção do
etc) para garantir que você não encontre erros inesperados, erros
ou colega. Os revisores não editam sua peça; eles estão lá para garantir
que o conteúdo pareça bom, para que sua peça seja completa e precisa.
Eles podem indicar áreas para melhoria ou erros no seu código. Antes de
pedir a alguém para revisar sua peça, esclareça o que deseja que eles
feedback, precisa saber qual tipo de feedback seria mais valioso para
você.
falar mais sobre isso daqui a pouco), sua postagem pode exigir edição
mais coesa e efi caz. Eles se preocupam com a maneira como uma
• Hemingway App
• Grammarly
• AlexJS
o que colocar como título. Uma vez eu trabalhei em uma empresa onde o
significava que, para cada e-mail que escrevi, eu tinha que apresentar
Para enfatizar, foram sete linhas de assunto por e-mail. Muitas vezes
1. Eles são a primeira coisa que seu leitor vê quando se depara com
sua postagem.
mecanismos de pesquisa.
site, mesmo que nunca tenham ouvido falar de você antes. É aqui que
qualquer consulta.
seja o mais específi co possível. Qual dessas opções é mais específi ca:
• How to Write Catchy Headlines and Blog Titles Your Readers Can’t
Resist
passo que você quer que os leitores sigam depois que terminarem de ler
sua postagem no blog. Os CTAs são usados com mais frequência pelos
Pense na jornada que o leitor fez para chegar ao seu post. O seu
leitor:
1. Teve um problema
busca)
Você pode:
relevante.
Aqui estão exemplos reais de como os CTAs podem ser usados nas
postagens do blog:
Descrição da
Tipo de post Objetivo CTA primário CTA primário
publicação
Junte-se à nossa
Uma postagem da Aumentar a
Confira o repositório equipe - estamos
equipe de engenharia conscienti
contratando
de uma empresa que Como postar/ zação sobre os
(Links para o
descreve o repositório Referir projetos de
repositório GitHub do (Links para a
monolítico usado para código aberto
projeto) página “Carreiras”
projetos Go desta empresa
da empresa)
Adicionando recursos
Recursos podem ser qualquer conteúdo que esteja vinculado à sua
melhor. Se você tiver apenas alguns links que deseja incluir, não há
houver vários links que você deseja incluir na sua postagem, coloque-os
postagem.
entender que a análise de mídia social pode ser usada para encontrar
blog.
usada e veja todas as suas postagens nos últimos dois meses. Você
precisa anotar:
outro.
dia da semana? Você pode escrever pequenos tweets como esse para
posts com essa tag? Você precisa escolher tags que aumentarão
alvo.
pesquise tags com base nas ideias do seu calendário de conteúdo. Abra
conteúdo. Elas devem ser descritivas, mas não com focos muito
destacar. Você não precisa pensar demais! Como linha de base, lembre-
se de:
nele. Pode funcionar para alguns leitores, mas não para todos. É
para você. Mas se você planeja mostrar suas coisas para um público,
análise de dados do site". Ela ajuda você a entender o que seus visitantes
quais links eles clicam, as páginas que visitam e onde caem. A análise do
Twitter e Facebook.
web (gratuita), mas não é o único provedor existente. Aqui estão outros
• Heap
• Mixpanel
• Simple Analytics
• Statcounter
no celular? Pode ser um bom momento para verifi car se o seu blog
mídias sociais. Por exemplo, você pode estar no Reino Unido, mas
horários do dia são mais adequados para você publicar uma postagem
Experimentação
funcionou por seis meses de repente pode não render tanto. Para
com a experimentação.)
É aqui que você declara o que “Quero ver se eu postar meu tweet num
Objetivos deseja aprender com esse determinado momento do dia levará mais
experimento. pessoas a clicarem no meu blog.”
As hipóteses declaram a
“Se eu promover meu post às 10h,
mudança que você deseja
Hipóteses mais pessoas o verão, o que trará
fazer e o resultado que deseja
mais cliques no meu blog.”
influenciar.
Declaração do
Objetivos Hipóteses Métricas Próximos passos
problema
As postagens são
publicadas em dias
Ver se a promoção
aleatórios da O post B recebeu 20
de uma postagem
semana e apenas curtidas, dois tweets
do blog em um dia
algumas pessoas e cinquenta
específico da Execute outro teste
veem minhas visualizações de
semana aumentará com outra postagem
postagens “Se eu promover página em sua
o envolvimento. do blog (postagem
promocionais nas meu blog às terças- primeira semana. C) para ver se você
mídias sociais. feiras, mais pessoas
(A publicação B será obtém resultados
clicarão nele.” A promoção do post
publicada em breve semelhantes com
A última publicação B teve um conteúdo diferente.
e será usada para
do blog (publicação desempenho muito
“testar” os tempos
A) recebeu três superior à promoção
de publicação e
curtidas no Twitter e do post A.
promoção.)
dez exibições de
página.
qualquer coisa: títulos de post de blog, tags, texto de mídia social e, sim, os
experiências futuras. Você pode usá-la para qualquer coisa que queira testar.
seguinte:
publicam?
aumentar seu alcance? Você quer que seu artigo apareça em uma
ideal é porque você leu o que eles publicam e acha que está alinhado
você já gosta de ler. Por quê? Porque você gostaria de escrever um artigo
publicam? Imagine tentar ser publicado no New York Times sem nunca
fazem. Se você não estiver pronto para pedir a alguém que analise e
um editor.
palavras!
envio. Se eles solicitarem que você use um formato específico, faça isso.
"melhores" quero dizer as que tenham a mais alta qualidade e das quais
artigo, mas significa que eles têm uma grande plataforma, o que
os seguintes itens:
There are data points that you can use to understand their reach.
Existem dados que você pode usar para entender o alcance deles.
comentários etc.).
sabe que tem uma viagem daqui a duas semanas, não prometa ao editor
minuto para enviar um e-mail ao seu editor. Informe a ele que você
para ser usada. Se você nunca criou uma biografia antes, aqui está uma
• Seu nome
• Seus interesses
• Suas realizações
favorecem o editor. Isso não significa que o editor está enganando você,
mas você deve entender com o que você está concordando. Algumas
ao editor.)
enviar.
pelas quais uma publicação pode decidir não avançar com sua matéria.
• Abandone a ideia e crie uma nova. Nem toda ideia é boa, e isso é
ou screencasts!
Títulos e descrições
contagem de inscritos.
público. Para que eles pressionem "Play" e ouçam ou assistam por cinco
técnico da The Coolest Co. Ltd. Aqui está minha primeira passagem na
interessadas.
entrevistando essa pessoa?". Ele quer saber por que isso é relevante. No
Coisas a incluir:
procurando.”
tecnologias de assistência.
Cada vídeo veio com uma transcrição em PDF para download de todos
a acompanhava.
garantir a qualidade.
Toques finais
Se o seu vídeo ou podcast exigir que os usuários baixem algo, crie uma
caixa de descrição. Torne mais fácil para o seu público encontrar o que
com o Rails 6.0? Você precisa incluir links para a documentação oficial do
• Podcast Accessibility
não exija ideias potencialmente boas. Seu primeiro rascunho não será
depois escreva sobre elas. Escreva mesmo quando não quiser. Para
Embora este livro não seja sobre escrita, quero deixar alguns
limita sua escrita a uma ou duas vezes por mês em que produz uma
precisa vê-lo, pelo que você pode escrever livremente sobre o que
quiser! Comece escrevendo uma página por dia. Alguns dias serão mais
deste livro inteiro ao longo de dez dias. Não tinha como eu conseguir
ajudá-los.
the Docs nesses locais; você aprenderá muito. O Write the Docs também
on-line da Catapult.)
ensinou como passar de uma nova ideia para outra. Não havia pré-
Conteúdo.
um exemplo de resposta:
(GitHub)
de conteúdo, UX
stephaniemorillo.substack.com
desenvolvimento de software
e não nas pessoas para quem criamos essas coisas. Kathy Sierra
querem de nós.
Fichas de trabalho
• bit.ly/dgtcc-ptbr-worksheets
• Open Demographics
• Hemingway App
• Grammarly
• AlexJS
• How to Write Catchy Headlines and Blog Titles Your Readers Can’t
Resist
Capítulo Bônus 2
• Podcast Accessibility
Butler por ser a primeira leitora deste livro e a Cynthia Zanoni e Glaucia
nenhuma outra e você nunca me diz o que eu quero ouvir. Minha escrita
Twitter: @radiomorillo.
***