Como contribuir para o Django é uma grande dúvida de quem gostaria de dar um passo a mais no mundo do open source. Mesmo tendo uma documentação que te guia em como fazer a sua primeira contribuição, existe um obstáculo no início dessa experiência: a escolha do seu primeiro ticket. Como lançar um foguete ou decolar um avião, é preciso primeiro superar a gravidade da Terra e a resistência do ar, o que exige uma quantidade imensa de energia nos primeiros segundos da jornada, mas à medida que vai se afastando da terra mais fácil vai se tornando a viagem.
O Ticket Trac é o agregador de issues do Django, é aqui onde você encontra os tickets disponíveis para trabalhar. Atualmente, existem cerca de 900 tickets aceitos. Pense no Trac como uma base de lançamento para suas contribuições: os filtros funcionam como a torre de controle, ajudando a selecionar os tickets certos para o "lançamento" do seu trabalho. Assim, aprender a usar os filtros é como dominar os comandos da missão, garantindo que você decole na direção certa e com eficiência.
Começar pequeno nesse processo pode ser um bom caminho, será mais fácil ter um feedback em um issue menor do que em um maior. Sendo assim, verificar se existem tickets “easy pickings” disponíveis pode ser uma boa estratégia. Mas, nem sempre eles estão de fato disponíveis, pois não são muitos tickets classificados nessa categoria.
Um possível caminho alternativo é recorrer ao “método Abutre” utilizando os filtros do Trac de forma estratégica para localizar outros tickets disponíveis. Como descrito por Sarah Boyce aqui nesse vídeo, nesse método busca-se diminuir a quantidade de tickets ao filtrar os tickets onde algum contribuidor começou a trabalhar no passado, porém deixou de contribuir já há algum tempo (algumas vezes a vida fica mais corrida, não é mesmo?), você então pode fazer a conclusão deste trabalho. Isso é uma ótima forma de começar, pois você já vai ter código, documentação, testes e revisões disponíveis, sendo um ótimo direcionamento para a sua jornada.
Aplicando esse método para o Trac seria algo assim - vale notar que dessa forma conseguimos reduzir o número de tickets disponíveis de 900 para 276:
- Has patch: yes.
- Modified: dois a três meses antes do momento em que você estiver pesquisando (isso não é uma regra, mas uma sugestão).
- Patch needs improvement: yes
- Triage stage: is accepted.
- Bônus: lembre-se de que os tickets com números mais altos são mais recentes. É provável que o ticket #34981 (aberto em novembro de 2023) seja mais fácil de resolver do que o #373 (aberto há 18 anos). - veja mais aqui.
A partir desse ponto, tire um tempo para ler cuidadosamente a descrição do ticket e entender um pouco mais sobre os seus detalhes. Caso você decida trabalhar nele, é importante deixar uma mensagem confirmando se o responsável anterior ainda pretende concluí-lo. É fundamental manter uma boa comunicação para evitar trabalhos duplicados, além disso a comunidade Django é incrivelmente acolhedora e está sempre disposta a ajudar.
Essa é apenas uma das formas possíveis de encontrar tickets que possibilitem a sua primeira contribuição. É importante que você explore outras maneiras e descubra a que melhor funciona para você. Durante essa jornada, você se tornará o expert do seu ticket, ganhará mais experiência e terá a oportunidade de trocar ideias com outros contribuidores do framework.
A propósito, a comunidade desempenha um papel fundamental nesse processo oferecendo todo suporte que você precisar, você não estará sozinho/sozinha! Você pode interagir com a comunidade nos seguintes canais: discord, Fórum do Django. Além disso, vale exaltar também o Djangonaut Space, um programa gratuito de 8 semanas de mentoria no qual você irá trabalhar em grupo em um ambiente de aprendizado e contribuição, saiba mais aqui.
Aperte os cintos, você já está pronta/pronto para sua decolagem no open source e no Django. 🚀🧑🚀
Fontes:
https://smithdc.uk/blog/2023/how_to_find_a_ticket_on_django_trac/
https://youtube.com/shorts/lojXKiXZoTo?si=QTGqij9is9js-oZT
https://docs.djangoproject.com/en/5.1/internals/contributing/writing-code/submitting-patches/#claiming-tickets
Top comments (0)