Guia Sprint

Bem-vindo aos Sprints do BeeWare!

Seja bem-vindo! Estamos muito felizes por ter decidido juntar-se a nós! Se ainda não se apresentou a um membro da Equipa Bee, por favor faça-o. Depois de fazer isso, volte aqui para começar.

O que é um sprint?

Um sprint é uma oportunidade não estruturada de passar algumas horas ou dias a trabalhar de forma colaborativa num projeto de código aberto. Eles geralmente estão vinculados a uma conferência; um sprint após uma conferência oferece uma oportunidade de transformar a energia, o entusiasmo e o interesse que a conferência gerou em melhorias no software que usamos diariamente.

Os sprints também são uma oportunidade de apresentar às pessoas o processo de contribuição para o projeto. Nossa esperança é que se divirta tanto durante o sprint que volte para casa e continue contribuindo!

Não importa quanta experiência tem. Em sprints anteriores, reunimos contribuições de pessoas com todos os níveis de experiência — estudantes do ensino médio, recém-formados em bootcamps, pessoas que não se consideram programadores e desenvolvedores experientes. Não importa o seu nível de experiência — podemos encontrar uma maneira de você contribuir.

O código também não é a única maneira de contribuir. Um projeto como o BeeWare é muito mais do que apenas o código - precisamos de pessoas para escrever, rever e traduzir a documentação; precisamos de pessoas para melhorar o desenho das páginas da Web; até mesmo o processo de analisar os bugs que foram relatados anos atrás e determinar se eles foram corrigidos ao longo do caminho é uma contribuição valiosa.

As Perguntas Iniciais

Para começar, faremos algumas perguntas para que possamos avaliar os seus interesses e experiência. Isso ajuda-nos a encontrar a melhor maneira de contribuir. Analise as perguntas, faça anotações e, em seguida, encontre um membro da Equipa Bee e partilhe as suas respostas. Se não entender a pergunta que está a ser feita - não se preocupe com isso! Diga-nos o que você sabe e trabalharemos juntos para descobrir a partir daí.

1. Já usou o BeeWare antes?

Se ainda não o fez, comece por trabalhar com o Tutorial BeeWare. Vai dar-lhe uma introdução sobre o que é o projeto BeeWare e como as partes do projeto se encaixam. Se encontrar algum problema ao fazer o tutorial, tome notas - porque garantir que ninguém mais tenha o mesmo problema é um ótimo tópico para uma primeira contribuição!

Depois de concluir o tutorial pelo menos até ao passo 4, passe para a próxima pergunta.

1. Que equipamento de computador tem consigo?

O equipamento que tem à disposição impõe limites práticos ao que pode contribuir. Por exemplo, se tem um portátil Windows, não poderá trabalhar em nada relacionado ao iOS. O seu portátil roda Windows, macOS, Linux ou outro sistema operativo? O seu telefone é um dispositivo iOS ou Android? Os seus dispositivos foram fornecidos pela sua empresa ou são seus dispositivos pessoais?

1. Quanta experiência tem a escrever código Python?

É novo na programação? Um veterano em Python? Um veterano em codificação que acabou de começar a aprender Python? Um recém-formado num programa de bootcamp? Queremos encontrar um problema que seja adequado ao seu nível de experiência.

1. Está familiarizado com os processos de contribuição do GitHub?

Usa o GitHub (ou um sítio semelhante de partilha de código) para hospedar o seu próprio código ou contribuir com projetos de outras pessoas? Sabe o que é CI (integração contínua)? Já contribuiu com um projeto que tem ganchos de pré-submissão? Se eu pedisse para “rebase o seu PR contra o principal”, saberia o que fazer?

1. Já contribuiu para um projeto de Código Aberto antes?

Já participou num sprint no passado? Já submeteu um PR (pedido de puxar) para um projeto de Código Aberto? Sabe como usar o GitHub para criar um pedido de puxar?

1. Tem alguma outra habilidade especial que possa ser útil?

Está familiarizado com uma API GUI (como WinForms, Cocoa ou GTK)? Tem conhecimento profundo do funcionamento interno dum sistema operativo específico? É especialista em alguma linguagem de programação diferente do Python? Se não tem nenhuma habilidade especial, não há problema — mas se tivermos um especialista em Windows nas nossas mãos, queremos garantir que essas habilidades sejam bem aproveitadas.

1. Por que se juntou a nós e no que está interessado?

“Pareceu ser um projeto amigável” é uma resposta perfeitamente aceitável. No entanto, se houver mais motivos para se juntar a nós hoje, conte-nos. Tem interesse em desenvolvimento para dispositivos móveis ou de ambiente de trabalho? Empacotamento? Sites? Aplicativos de consola? Se não tem um interesse específico, o que parece mais interessante com base no que viu sobre o BeeWare até agora?

Agora, encontre um membro da Equipa Bee para partilhar as suas respostas. Eles podem fazer algumas perguntas de acompanhamento; mas depois vão indicar-lhe a direção de uma área em que poderá fazer uma contribuição.

Encontrar o Seu Problema

Se conversou com um membro da Equipa Bee, ele provavelmente indicou uma parte do projeto BeeWare na qual pode contribuir; ele pode até ter sugerido um problema específico onde você trabalhar. Se não lhe deram uma questão específica, provavelmente indicou as “Boas Primeiras Questões” para esse projeto. O que isso significa?

O GitHub fornece uma lista de problemas que permite que o BeeWare (e outros projetos) mantenham o controle de todos os problemas que foram relatados - isso inclui bugs explícitos, comportamentos inesperados que podem ser um bug, solicitações de novos recursos, solicitações de mais documentação - qualquer coisa que possa ser uma forma de melhorar o BeeWare. Conforme novos problemas são reportados, a Equipa Bee vai sinalizar alguns deles como problemas que são bem adequados para um colaborador iniciante - problemas que não exigem uma correção imediata, mas que são bem definidos ou fáceis de reproduzir, e provavelmente têm uma boa pista sobre a causa subjacente. Esses problemas são marcados com a etiqueta "good first issue" para os tornar fáceis de encontrar.

Para filtrar uma lista de problemas do GitHub pela etiqueta “good first issue”, siga estes passos:

1. Clique no botão "Etiquetas" em cima da lista de problemas para ativar o menu de desenrolar.
2. Digite a palavra “good” na caixa de pesquisa na topo do menu de desenrolar..
3. Clique em “good first issue” na lista filtrada.

Filtrar problemas do GitHub pela etiqueta “good first issue”.

Depois de encontrar um problema que pareça interessante, leia todos os comentários da publicação e deixe um comentário na discussão informando que está a analisar o problema (ex., “Vou analisar isto nos sprints da PyCon US 2026”). O BeeWare não “atribui” explicitamente os problemas — aceitamos contribuições de qualquer pessoa. No entanto, numa situação de sprint, precisamos garantir que não temos duas pessoas a trabalhar no mesmo problema — deixar um comentário é uma maneira simples de coordenar entre os colaboradores.

Se ainda não conseguir encontrar algo que gostaria de fazer, procure um membro da Equipa Bee Team e ele vai ajuda-lo a concentrar-se num problema específico.

Configurar um ambiente de desenvolvimento

Assim que encontrar um problema, vai precisar configurar o seu ambiente de desenvolvimento para poder trabalhar numa correção. Cada projeto do BeeWare tem o seu próprio guia de contribuição:

• Briefcase
• Toga
• Rubicon ObjC

Se o projeto não estiver nesta lista, verifique o LEIA-ME do projeto para obter detalhes sobre como configura-lo. Se alguma das instruções não fizer sentido (ou não conseguir encontra-las), procure um membro da Equipa Bee e ele o ajudará a livrar-se do problema. E, se achar que pode melhorar as instruções para que outras pessoas não tenham o mesmo problema, melhorar o guia de contribuição é uma contribuição valiosa!

Agora pode começar a trabalhar no seu problema!

O que acontece depois que eu submeter o meu pedido de puxar (PR)?

Depois que enviar o seu pedido de puxar e ele for aprovado em todas as verificações automáticas, vai estar pronto para uma revisão. Informe um membro da equipa principal que você tem um PR pronto para revisão, e eles vão vê-lo.

Se este for seu primeiro PR, é bem provável que a revisão encontre alguns problemas. Pode ser um caso extremo que não considerou ou uma convenção de código que não seguiu. Não fique desanimado! Ninguém - nem mesmo a equipa principal - consegue PRs 100% corretos na primeira tentativa.

Assim que a PR passar na revisão, o seu revisor irá fundir a PR - e está feito! Parabéns - você contribuiu para o BeeWare! Se esta for sua primeira contribuição para o BeeWare, também ganhou a sua Medalha de Mérito BeeWare - procure um membro da equipa principal e ele vai dar-lhe uma medalha!

Ajuda! Estou encravado!

Se ficar preso nalgum ponto do caminho, procure um membro da Equipa Bee. Não tenha medo de fazer qualquer pergunta. Se estiver preso, nós queremos solta-lo. Se estiver confuso, é porque o tópico é complicado e não o explicamos suficientemente bem. Estamos ansiosos para ajudar - e queremos garantir que você tenha um sprint bem-sucedido.

E se eu não concluir a minha contribuição durante o sprint?

Não há problema! Pode submeter uma contribuição a qualquer momento. Um dos objetivos dos sprints é incentiva-lo e capacita-lo a continuar a contribuir ao longo do resto do ano. A Equipa Bee está disponível para ajudar em qualquer parte deste processo.

Se já estava a trabalhar num problema do GitHub ou submeteu um PR, pode continuar a comunicar através do GitHub. Se tiver outras dúvidas ou precisar de ajuda em tempo real, o melhor lugar para nos encontrar é o servidor BeeWare Discord. Estamos ansiosos para continuar a trabalhar consigo!

Melhorar este guia

Se tiver alguma sugestão sobre como melhorar este guia de sprint, informe-nos disso. O que funcionou para si? O que não funcionou? O que podemos fazer melhor? E lembre-se: consertar um problema com este Guia de Sprint conta como uma contribuição para o BeeWare!