Como um bom blog técnico de empresa é administrado

 (danluu.com)
12 pontos por xguru 2020-03-12 | 5 comentários | Compartilhar no WhatsApp

Pontos em comum de blogs técnicos atraentes

  • A aprovação é fácil ou quase não é necessária

  • O processo de aprovação/edição torna os posts mais atraentes para os engenheiros

  • Suporte em nível C

Pontos em comum de blogs técnicos pouco atraentes

  • Processo lento e com muitas etapas de aprovação

  • Também é necessária aprovação de áreas que não são técnicas

  • O processo de aprovação/edição serve principalmente para remover riscos, eliminar referências a certos conteúdos ou tornar o post vago, deixando-o menos interessante para os engenheiros

  • Não há apoio em alto nível

Processos de 3 empresas bem administradas, organizados a partir de entrevistas

Heap

▪ Se alguém tem uma ideia para escrever um texto

▪ O autor (engenheiro) faz par com um "buddy" que edita e aprova o texto

▫ O buddy é um engenheiro com histórico de boa escrita

▫ Ao longo de algumas rodadas, o ponto principal (thrust) do texto pode mudar

▪ O CTO lê e aprova

▫ Normalmente dá feedbacks pequenos

▫ Sugestões no nível de "um designer poderia deixar este gráfico mais bonito"

▪ Publicação do texto

  • No primeiro estágio de edição, compartilhavam o rascunho em um canal do Slack para que qualquer pessoa pudesse dar feedback,

mas como a experiência não foi muito boa, o processo foi desenhado para evitar receber "feedback demais" nessa etapa

Segment

▪ Se alguém tem uma ideia para escrever um texto

▫ Muitas vezes ela vem de documentação interna, apresentações externas, projetos lançados ou open source desenvolvido internamente

▪ O autor (engenheiro) escreve o rascunho

▫ Às vezes um engenheiro sênior ajuda a trabalhar no rascunho

▪ Até recentemente, não havia um processo de feedback

▫ O cofundador e o gerente de engenharia davam a maior parte do feedback

▫ Também havia feedback de gerentes e tech leads

▫ Em geral, fica pronto por volta da terceira versão

▫ Um editor em tempo integral começa a editar

▪ A equipe técnica é avisada, e o texto recebe feedback de cerca de 15 a 20 pessoas

▪ PR e jurídico revisam, em uma etapa leve de aprovação

  • Existe um programa chamado "Blogging Retreat", em que se reserva uma semana para escrever no blog

  • Foram estabelecidos critérios explícitos para que Writing e Speaking possam ser recompensados na avaliação de desempenho e na carreira (career ladder)

CloudFlare

▪ Se alguém tem uma ideia para escrever um texto

▫ O blogging interno faz parte da cultura da empresa, e alguns posts vêm do blog interno

▪ O CTO lê todos os textos, e outras pessoas também leem e comentam

▫ O CTO aprova o texto

▪ O CEO é o patrocinador do blogging

▪ Processo de aprovação jurídica "muito rápido", com SLO de menos de 1 hora

▫ Tão leve que às vezes parece que nem existe

Como o texto foi escrito com base em apenas 3 empresas, é arriscado generalizar a partir disso, mas o apoio da liderança é importante

Leituras relacionadas

5 comentários

 
heycalmdown 2020-03-20

Seria realmente útil ter um editor em tempo integral que, mais do que apontar problemas no conteúdo, avaliasse a partir da perspectiva de como escrever para que o texto seja bem lido.
 
xguru 2020-03-12

Aqui, recentemente, houve um texto da Market Kurly no mercado nacional, mas ele não está no GeekNews. Vale a pena ver junto, relacionado ao tema.

"Redesenhando o blog técnico" https://helloworld.kurly.com/blog/redesign-tech-blog/

Coletânea de blogs técnicos de startups, relato de desenvolvimento https://pt.news.hada.io/topic?id=1536

O endereço do site de coletânea de blogs técnicos de startups nacionais que você criou mudou.

https://metapost.dev/
 
changjoopark 2020-03-12

Ótimo texto, obrigado :)

Não dá para editar o texto no celular?
 
xguru 2020-03-13

Ah, o GeekNews não tem função de edição ^^;;
 
changjoopark 2020-03-13

Ah, entendi ;_;

Obrigado por avisar