Manual de Developer Advocacy

Versão mais recente do "Manual do Evangelista de Desenvolvedores", publicado por Christian Heilmann há 15 anos

• O que é Developer Advocacy / Evangelism?

→ Definir

→ A mentalidade correta: uma pessoa que gera mudança para desenvolvedores

→ O papel e como usar seus pontos fortes

• Colaborar com a sua própria empresa

→ Preparar-se para preconceitos: um papel único que atravessa várias funções. Não desanime

→ Lidar com mudanças na empresa: siga os processos legais. Não existe "off-the-record". Não aja por emoção nem faça suposições

→ Estar ao lado dos desenvolvedores internos: escute

→ Trabalhar com PR e marketing: não são concorrentes, comunique-se continuamente

→ Ser reconhecido como um canal externo: deixe os membros saberem com quais canais você está conectado

→ Educar outros Advocates e desenvolvedores: faça treinamentos e palestras internas, e compartilhe feedback externo

→ Compartilhar tecnologias úteis: comunique internamente o que você aprendeu

→ Equilibrar canais pessoais e oficiais

→ Remover a marca: separe sua identidade da marca da empresa. Foque apenas em permitir que desenvolvedores explorem o produto

• Colaborar com concorrentes

→ Ao trabalhar com concorrentes:

→ ✓ seja uma pessoa independente, interessada no que é relevante independentemente de qual empresa seja o produto

→ ✓ acostume-se sempre com novidades

→ Respeitar concorrentes: não dá para ser um ótimo DA e ao mesmo tempo alguém briguento.

→ Admitir quando o produto do concorrente é melhor: valorize boa tecnologia, não tenha medo da concorrência e até dê feedback ao time interno

→ Conhecer os concorrentes: para comparar e falar sobre eles, primeiro é preciso conhecê-los

→ Criar e usar exemplos com produtos concorrentes: isso permite comparar e entender as diferenças

• Preparar outreach

→ Confirmar os fatos com precisão: pergunte detalhadamente ao time de produto sobre especificações corretas, recursos e o que não é suportado

→ Conhecer o público e suas necessidades

→ Preparar especialistas de apoio:

→ ✓ anote perguntas que você não conseguir responder e faça acompanhamento depois

→ ✓ não prometa algo que você não tem certeza de que o time de produto poderá entregar

→ Escolher a mídia adequada: slides, vídeo, áudio, live coding, exemplos online passo a passo..

→ Preparar-se para falhas:

→ ✓ cópias locais e online dos slides.

→ ✓ salvar separadamente em um pendrive.

→ ✓ preparar-se para seguir com Q&A caso os slides não funcionem

→ ✓ o online pode falhar a qualquer momento, então tenha algo local ou um hotspot

• Encontrar oportunidades para falar

→ Participar de podcasts

→ Participar de painéis: torne-se especialista em um tema específico ou membro de um grupo

→ Participar de barcamps/meetups: apresentações curtas

→ Escrever artigos para revistas online etc.

→ Conduzir sessões brown bag: seminários na hora do almoço

→ Fazer perguntas em conferências

→ Tornar-se alguém que os organizadores queiram convidar: publique e divulgue seus temas de palestra (Term)

→ ✓ dados pessoais, biografia atualizada, slides/vídeos recentes

→ ✓ temas que quero abordar, tecnologias que uso

→ ✓ o que espero de organizadores de conferências etc.

• Viagens e participação em conferências

→ Dicas de viagem: deixe um dia de folga de buffer, viaje de forma econômica

→ Quem paga os custos?

→ Participe de vários eventos no local da conferência e socialize com outros palestrantes

→ Usar redes sociais ao participar de eventos:

→ ✓ deixe seus contatos de redes sociais nos slides

→ ✓ divulgue sua participação na conferência com hashtags etc.

→ ✓ compartilhe conteúdos divertidos ou boas palestras

→ ✓ republique notícias dos organizadores da conferência

→ ✓ publique os slides online e avise as pessoas

→ Construir networking por meio de eventos

→ Criar e manter um calendário para acompanhar presença em eventos

→ Aproveitar o buzz da conferência

→ Fazer parte da conferência em que você apresenta

→ Publicar imediatamente a apresentação e materiais relacionados

→ Escrever sobre a conferência

• Conduzir apresentações e workshops

→ Seja você mesmo: seu maior ativo é a confiança em si mesmo.

→ Convide à comunicação

→ Prepare materiais para os participantes levarem consigo (takeaways)

→ Prepare a sessão de Q&A e mantenha controle total dela

→ Seja honesto e diga apenas a verdade: não chute respostas quando não souber

→ Faça follow-up após a apresentação

• Dicas de apresentação: manter o tempo e outros pontos

→ Como encaixar tudo isso em X minutos

→ Less is More: comece com uma coisa importante (insights, resultados de pesquisa, o estado atual de X, novos recursos do produto X). O que as pessoas devem lembrar desta apresentação?

→ Sua apresentação é muito importante apenas para você

→ ✓ sua apresentação é apenas uma entre muitas outras

→ ✓ sua apresentação será gravada e espalhada por vários lugares

→ ✓ as pessoas não vão lembrar do conteúdo inteiro

→ ✓ as pessoas não precisam de você para obter essa informação. Ela pode ser encontrada facilmente online

→ Organizar informações adicionais

→ Live coding? Coisas com as quais é preciso tomar cuidado

→ Evitar perguntas

→ O que cortar: slides de agenda, informações da empresa, apresentação pessoal, piadas e memes

→ O que pode servir como conteúdo de preenchimento durante a apresentação: onde estão os materiais, como entrar em contato, colegas e especialistas com quem falar além de mim..

→ Preparar um resumo da apresentação

• O que não dizer no palco e alternativas

→ "Isso é fácil": "para fazer isso, basta passar por algumas etapas", "essas ferramentas têm boa documentação, então você também pode.."

→ "Só para repetir rapidamente para quem talvez não saiba": "em outras palavras, X é..", "como vocês sabem, X é..."

→ "Qualquer um consegue fazer": "fazendo isso, o restante do trabalho vai ficar mais agradável" "como isso é muito eficaz, experimente e conte para outras pessoas"

→ "X vai resolver esse problema, então não se preocupe": "como X resolve problemas relacionados a Y, você pode criar Z"

→ "X foi criado para tornar Y mais fácil e já está em uso real. Os resultados também são animadores"

→ "Como todos vocês sabem": "isso tem sido muito comentado ultimamente e está bem explicado em X(link)"..

→ "Como aprendemos na escola": "isso fazia parte do currículo de ciência da computação, e há um bom motivo para isso"

→ "Y(nosso produto) é muito melhor que X(concorrente).": "é assim que isso é feito usando X. Nós adotamos uma abordagem diferente, e estes são os motivos."

→ "Existem várias soluções para isso. Sabemos que faltam em X alguns recursos que poderiam torná-lo mais eficiente.."

→ "Dá para fazer com apenas algumas linhas de código": "como vocês podem ver, é possível começar com algumas linhas de código. Eu simplifiquei para mostrar aqui, e o código-fonte está em X"

→ "Se você quer se tornar um especialista (profissional), faça X": "a vantagem de X é Y, por isso ele se torna uma ferramenta profissional para usar.

→ Além disso, assista às suas próprias palestras/vídeos e pense: "se eu não soubesse disso, como seria ouvir essa fala?"; então corte ou reformule o conteúdo

• Escrever bons textos e artigos

→ Simple is not stupid: escrever de forma fácil de entender e simples é muito difícil. Use palavras simples, termos que um público amplo entenda e frases concisas

→ Vá ao ponto. Não enfeite

→ O tamanho do texto importa. Textos técnicos para online devem ser curtos e passar apenas o essencial. Se ficar longo demais, divida em vários textos

→ Adicione mídias variadas e relevantes: vídeo, áudio, slides, imagens etc.

→ Estruture o conteúdo com headings hierárquicos etc.

→ O conteúdo também precisa de prazo de validade.

→ Cite outras fontes para comprovar

→ Escrita preemptiva (Pre-emptive) - faça com que seu produto desperte interesse nos desenvolvedores. Quem "vende" é o time comercial

• Escrever ótimos exemplos de código

→ Resolver problemas por meio de exemplos

→ Mostrar exemplos que funcionam

→ Explicar o ambiente necessário

→ Escrever código que possa ser copiado e colado

→ Oferecer download dos exemplos

→ Escrever exemplos limpos e inteligentes

→ Hospedar código e demos

→ ✓ controle de versão é seu amigo

→ ✓ fazer hospedagem automática

→ ✓ usar code sandboxes

→ ✓ ambiente de live coding

• Preparar ótimos materiais de apresentação

→ Saber claramente o que você conhece

→ Começar pelo conteúdo em si, não pelos slides

→ Começar a escrever em um formato de texto portátil

→ Dica para criar slides rapidamente: decompor bullets

→ Escolher e preparar uma boa ferramenta de apresentação

→ ✓ deve conseguir mudar entre 16:9 e 4:3 sem problemas

→ ✓ deve ser fácil cortar e redimensionar imagens

→ ✓ deve permitir mover objetos livremente na tela

→ ✓ deve permitir controle remoto

→ ✓ a transição para outros materiais deve ser suave

→ ✓ suporte a tela cheia

→ ✓ possibilidade de exibir itens um a um

• Criar ótimos slides para apresentação

→ Não registre tudo em texto; explique com frases curtas/imagens/capturas de tela/gráficos

→ Encontrar e usar boas imagens

→ Tornar exemplos de código agradáveis de ver

→ Dicas para usar som e vídeo

→ Use animações apenas onde necessário (sem exagerar no brilho)

→ Seja conciso - se possível, cubra apenas um tópico

→ Leve o público em consideração

→ Quando houver template da empresa ou da conferência

→ Personalize (internalize) todos os materiais antes de usar: não reutilize exatamente como recebeu de outra pessoa

→ Compartilhe e aproveite

→ Dicas extras para apresentação

→ ✓ apresentação pessoal: por que sou a pessoa adequada para falar sobre isso e por que/o que quero falar

→ ✓ usar humor: tome cuidado para não atacar outras pessoas

→ ✓ criar conexão com a realidade

→ ✓ controle o ritmo para não falar rápido demais: pequenas pausas ajudam o público

→ ✓ evite "Hello World"

→ ✓ se possível, use materiais novos. Mantenha tudo atualizado

• Checklist para apresentações mais fáceis de entender, acessíveis e acionáveis

→ Material de apresentação

→ ✓ É HTML/PPTX/PDF ?

→ ✓ O código está online ?

→ ✓ Vídeos/áudios embutidos podem ser reproduzidos independentemente do OS e também offline ?

→ Formato

→ ✓ As mídias embutidas têm recursos de acessibilidade? (legendas, texto alternativo, transcrição etc.)

→ ✓ A fonte é grande o suficiente ?

→ ✓ Está no tamanho certo para a conferência ? 16x9, 4x3

→ ✓ O contraste é suficiente para continuar visível mesmo se o projetor tiver problemas ?

→ ✓ Há margem de segurança caso o projetor corte parte da tela ?

→ ✓ Ao apresentar em outro computador, você precisa de fontes alternativas ?

→ Conteúdo

→ ✓ Não há conteúdo agressivo nem potencialmente gatilho ?

→ ✓ Dá para entender sem um contexto específico ?

→ ✓ Há termos que intérpretes/tradutores precisam conhecer antes ?

→ ✓ Existe algo que possa ser mal interpretado se apenas uma parte/um slide for compartilhado ?

→ ✓ Todas as mídias e materiais têm fonte atribuída e direitos autorais verificados ?

→ Rastreamento

→ ✓ Dá para saber quem baixou o material ?

→ ✓ Há um call-to-action no slide final e um link para download

→ Seguro

→ ✓ Todos os materiais podem ser acessados offline independentemente do computador ? (incluindo slides/exemplos/mídias, tudo em um pendrive)

→ ✓ Há material explicativo preparado caso vídeo/áudio não funcione corretamente

• Registrar todo o trabalho

→ Grave todas as apresentações em áudio

→ Se possível, grave também em vídeo

→ Reúna e registre em um só lugar todos os links usados na apresentação

→ Mantenha uma lista de todas as conferências em que fui/vou participar: incluindo slides/blog/links/links de vídeo

• Conhecer e usar a web (social)

→ Encontrar bom conteúdo na web

→ Redistribuir conteúdo da web: escrever em blog, registrar em sites de social bookmarking, usar em slides, citar em mailing lists ou fóruns, postar no Twitter

→ ✓ sempre faça a devida atribuição ao autor original

→ Tornar-se conhecido na web

→ Usar sites e produtos sociais fortes: Flickr, YouTube, Vimeo, Archive.org, GitHub, LinkedIn, Facebook, Meetup, Twitter

→ Usar a web como repositório, canal de distribuição e ferramenta de cross-promotion

→ Dar pistas sobre o produto, fazer tease e mostrar previews

→ Acompanhar efeitos: adicionar telemetry à documentação/blog, assinar feeds de comentários, usar encurtadores de URL com rastreamento

→ Construir rede de contatos

→ Criar ou participar de newsletters

→ Criar ou participar de podcasts

• Trabalhar no meu computador

→ Equipamentos: microfone externo, monitor, câmera, iluminação

→ Fazer screencasts e capturas de tela

→ Streaming

→ Participar de chats online em tempo real

→ Cuidados e dicas ao participar de eventos online em tempo real

• Dicas para gravar minhas apresentações online

[xguru]

O título da versão anterior era Developer Evangelist Handbook, mas hoje em dia usa-se a palavra Advocacy em vez de Evangelist/Evangelism, então isso foi refletido.

Este também é um livro que eu consultava quase como uma bíblia quando trabalhava como developer evangelist em 2010.

O autor trabalhou como desenvolvedor por 20 anos e é um veterano que vem atuando nessa função há mais de 10 anos na Yahoo, Mozilla e Microsoft.

Há várias formas de expressar isso, como Developer Advocate/Evangelist/Relations, mas acho que vale a pena para todas as pessoas que trabalham com essa área e também para desenvolvedores que fazem muitas apresentações externas consultarem este material.

Na parte de criação de materiais de apresentação, a ideia de "não reutilize sem personalizar - Don't reuse without personalising" é algo que eu também enfatizo muito.

Quando se usam imagens/diagramas tirados de algum lugar, muitas vezes há partes que não se encaixam, e em muitos casos a própria pessoa nem entende completamente aquele diagrama.

Se possível, recomendo redesenhar e usar de acordo com a sua própria interpretação e com o conceito dos seus materiais de apresentação.

[sangkyoonnam]

Obrigado pela boa organização. A expressão “não reutilize sem personalizar” — Don't reuse without personalising — soa como uma tradução muito literal, então, no contexto que você mencionou, algo como “internalizar e reutilizar” talvez fique mais fácil de entender.

[xguru]

Agora que escrevi, vi que é isso mesmo ^^; já refleti isso de leve. Obrigado.

[sangkyoonnam]

@_@)b