Como quebrar o processo de inscrição no Google Season of Docs para 2020

Ao longo dos anos, pesquisas têm mostrado a importância de uma boa documentação em como os desenvolvedores escolhem e usam o código aberto.

No programa inaugural Google Season of Docs (GSoD) em 2019, o programa recebeu quase 450 inscrições de redatores técnicos e mais de 50 redatores técnicos foram aceitos.

Como um dos redatores técnicos que foram aceitos para participar do programa Google Season of Docs, pensei em compartilhar alguns insights sobre como preparar e criar um aplicativo forte para o programa GSoD.

Índice

  • O que é o Google Season of Docs?
  • Quem está qualificado para participar do programa?
  • Benefícios de participar
  • 5 dicas para aprimorar seu aplicativo GSoD
  • Minha experiência GSoD
  • Recursos úteis

O que é o Google Season of Docs?

O Season of Docs é um programa anual organizado pelo Google. Seu objetivo é reunir escritores técnicos e organizações de código aberto para promover a colaboração e a melhoria da documentação no espaço de código aberto.

Essa iniciativa é extremamente importante porque a documentação de um projeto de código aberto fornece uma avenida para que os usuários não apenas entendam o projeto, mas também façam contribuições para ele.

Durante o programa, escritores técnicos aceitos passam de 3 a 5 meses construindo um novo conjunto de documentos, melhorando a estrutura dos documentos existentes, desenvolvendo um tutorial muito necessário ou melhorando os processos de contribuição e guias de uma organização de código aberto.

Quem está qualificado para participar do programa?

De acordo com as regras do Google, você deve ter pelo menos 18 anos de idade no momento do registro. Você também deve ter experiência anterior como redator técnico e ser elegível para trabalhar em seu país de residência.

Se você atender a essas qualificações, poderá se inscrever para participar do programa Google Season of Docs.

Benefícios de participar

Há tantos benefícios em participar do programa Temporada de Documentos. Alguns são:

Você pode conseguir um estipêndio

Depois de concluir o programa Google Season of Docs, você recebe uma bolsa do Google. É importante observar que este estipêndio é opcional, portanto você deve indicar que deseja ser pago durante a fase de inscrição.

O valor do estipêndio é calculado com base em sua localização. Veja aqui os detalhes completos sobre os estipêndios.

Você melhora suas habilidades

Outro benefício óbvio de participar do programa Google Season of Docs é que ele permite que você aprimore suas habilidades como redator técnico.

Você expande sua rede

Além de melhorar como redator técnico, você também terá a oportunidade de trabalhar com pessoas que fazem coisas incríveis no espaço de código aberto.

No meu caso, tive a oportunidade de trabalhar com a organização VideoLAN e isso significava que precisava trabalhar em estreita colaboração com o presidente da organização e os principais contribuintes dos projetos.

Você pode obter recomendações e referências

Ao se candidatar a qualquer emprego, ter uma boa carta de recomendação geralmente ajuda a fortalecer sua candidatura.

Trabalhar junto com um mentor no projeto Season of Docs apresenta uma oportunidade de garantir uma rica fonte de recomendações e referências.

Você ganha acesso a oportunidades futuras

Se você está pronto para se candidatar a uma função de redator técnico no Google, incluir sua experiência na Temporada de Documentos em seu currículo oferece mais vantagens em comparação com outros candidatos.

Você se torna um contribuidor de código aberto

Além de todos os benefícios mencionados acima, participar do programa Season of Docs significa que você pode contribuir para projetos de código aberto. Isso ajuda o mundo a desmascarar o estereótipo de que as contribuições de código aberto são destinadas apenas a desenvolvedores de software.

5 dicas para aprimorar seu aplicativo GSoD

Aqui estão 5 dicas para ajudá-lo a preparar e criar um aplicativo forte para o programa Temporada de Documentos.

Crie e publique artigos em seu blog

Um dos critérios mais importantes para ser aceito como redator técnico no programa Google Season of Docs é a capacidade de mostrar que você tem experiência anterior em redação.

O Google e os mentores propostos para o projeto no qual você deseja trabalhar precisam ser convencidos de que você é a pessoa certa para trabalhar no projeto. Isso significa que eles desejam ver uma boa quantidade de documentação e artigos bem escritos que você criou.

Felizmente, não é tarde demais para criar um blog ou publicar mais conteúdo em seu blog já existente.

Se você já tem um blog, é uma boa ideia publicar mais artigos bem escritos antes, durante e depois de enviar sua proposta. Se você não tem nenhum blog, ainda não é tarde para criar um usando o Devblog de Hashnode ou sua plataforma preferida e publicar artigos bem escritos também.

Escolha o projeto de código aberto certo

Honestamente, não posso enfatizar demais a importância de escolher o projeto de código aberto certo. Isso ocorre porque ele tem um papel importante a desempenhar para que você entre no programa.

Aqui estão minhas idéias sobre como escolher o projeto certo:

  • Percorra todos os projetos aprovados e tente selecionar pelo menos 5 projetos de seu interesse.
  • Depois de selecionar pelo menos 5 projetos, faça a varredura novamente e reduza os projetos para um máximo de 3 projetos e um mínimo de 2 projetos.
  • Embora possa ser razoável se concentrar em um projeto durante a fase de inscrição, encorajo você a se inscrever em pelo menos dois projetos para aumentar suas chances de ser aceito em pelo menos um projeto.
  • Para cada projeto que você escolher, entre no canal de comunicação da organização e informe os mantenedores do projeto sobre o seu interesse por aquele projeto. Dessa forma, você poderá estabelecer um relacionamento entre você e o mentor. Além disso, observe que os mentores não escolhem as pessoas apenas porque possuem as habilidades necessárias. Eles também selecionam candidatos porque acreditam que também podem trabalhar com eles. Portanto, ao enviar uma mensagem a um mentor, seja explícito sobre exatamente o que você precisa e, o mais importante, não fique chateado por eles não terem respondido imediatamente, porque a maioria dos mentores são voluntários que têm outros empregos em tempo integral.
  • Não espere para ser alimentado com colher. Faça muitas pesquisas sobre o projeto. Descubra e entenda tudo o que você precisa saber e, se tiver alguma dúvida, peça ajuda ao mentor proposto para esse projeto ou peça a outros membros dessa comunidade.
  • Mais importante ainda, anote tudo o que descobrir durante a pesquisa que será útil se você for aceito para trabalhar no projeto ou informações que ajudem a melhorar sua proposta.

Escreva uma proposta

Muitas pessoas não sabem disso, mas escrever uma proposta é vital. Dá a você uma compreensão clara da meta do projeto, o cronograma necessário para concluí-lo, o que você precisa saber e assim por diante.

Além disso, escrever uma proposta também mostra a seu mentor seus objetivos para o projeto, por que você acredita que é a pessoa certa para a função, sua experiência, cronogramas do projeto e muito mais.

Após redigir sua proposta, envie-a ao mentor do projeto para revisão. A revisão deles ajudará você a conhecer os requisitos do projeto do ponto de vista do mentor. Eu adicionei um link para minha proposta do Google Season of Docs na seção Recursos.

Faça pelo menos uma contribuição para a organização de código aberto

O programa Season of Docs não é como o Google Summer of Code, em que você deve fazer pelo menos uma contribuição para o projeto de código aberto de seu interesse. Mas fazer uma contribuição pode definitivamente aumentar sua chance de ser aceito, então tente fazer isso.

Permaneça ativo na comunidade após o prazo de inscrição

Depois de enviar sua inscrição, tente permanecer ativo nessa organização de código aberto. Isso mostra aos mentores que você é apaixonado por esse projeto e pela comunidade Open Source em geral.

Minha experiência GSoD

Durante o programa GSoD no ano passado, tive a oportunidade de trabalhar com a organização VideoLAN no projeto Modernizar (reescrever) a documentação do usuário VLC.

Depois que minha proposta foi aceita pela organização VideoLAN, meus mentores e eu concordamos com as metas que eu esperava alcançar durante o programa Google Season of Docs.

Esses eram meus objetivos:

  1. Reestruture a documentação.
  2. Atualize a documentação para se adequar às versões modernas do VLC.
  3. Migre a documentação do usuário para Gitlab usando Sphinx e ReadtheDocs.
  4. Remova imagens e informações obsoletas.
  5. Reescreva a documentação do usuário para torná-la fácil de entender.
  6. Configure-o para tradução usando o Sphinx Internationalalization.

Aprendi muito mais sobre a organização VideoLAN e o VLC, descobri que o VLC tem mais recursos que eu nunca conhecia e aprendi como usar a plataforma de documentação Sphinx e reestruturar o texto.

Minhas habilidades de redação técnica também melhoraram tremendamente. No geral, participar do programa Google Season of Docs foi uma das melhores coisas que me aconteceram em 2019.

Recursos úteis

Encontre abaixo uma lista de recursos úteis para ajudá-lo a aprender mais sobre o programa Temporada de Documentos e Redação Técnica.

  • Minha proposta de Temporada de Documentos aceita
  • Relatório de projeto do Google Season of Docs
  • Contribuições de código aberto: um catalisador para o crescimento
  • Guia do redator técnico
  • Canal do Slack do Season of Docs
  • Redação técnica incrível

Gostou deste artigo? Siga @Didicodes no Twitter.