Guia Sprint

Bem-vindo ao BeeWare Sprints!

Seja bem-vindo! Estamos muito felizes por você ter decidido se juntar a nós! Se você ainda não se já se apresentou a um membro da Bee Team, faça isso. Quando 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 trabalhando de forma colaborativa em um projeto de código aberto. Eles geralmente estão vinculados a uma conferência. 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 você se divirta tanto durante o sprint que você volte para casa e continue contribuindo!

Não importa quanta experiência você 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, revisar e traduzir a documentação, precisamos de pessoas para escrever, revisar e traduzir a documentação; precisamos de pessoas para melhorar o o design 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 seus interesses e experiência. Isso nos ajudará a encontrar a melhor maneira de você contribuir. Analise as perguntas, faça anotações e, em seguida, encontre um membro da Bee Team e compartilhe suas respostas. Se você não entender a pergunta que está sendo feita - não se preocupe com isso! Diga-nos o que você nos informe o que você sabe e trabalharemos juntos para descobrir a partir daí.

1. Você já usou o BeeWare antes?

Se ainda não o fez, comece por trabalhar com o Tutorial BeeWare. Ele lhe dará 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 até, pelo menos, a etapa 4, passe para a próxima pergunta.

1. Que equipamentos de informática você tem com você?

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

1. Quanta experiência você tem escrevendo código Python?

Você é 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 em um programa de bootcamp? Queremos encontrar um problema que seja adequado ao seu nível de experiência.

1. Você está familiarizado com os processos de contribuição do GitHub?

Você usa o GitHub (ou um site semelhante de compartilhamento de código) para hospedar seu próprio código ou contribuir com projetos de outras pessoas? Você sabe o que é CI (integração contínua)? Você já contribuiu com um projeto que tem ganchos pré-confirmação? Se eu pedisse para você “rebase seu PR em relação ao principal”, você saberia o que fazer?

1. Você já contribuiu para um projeto de código aberto antes?

Você já participou de um sprint no passado? Você já enviou um PR (pull request) para um projeto de código aberto? Você sabe como usar o GitHub para criar um pull request?

1. Você tem alguma outra habilidade especial que possa ser útil?

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

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

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

Agora, encontre um membro da Bee Team para compartilhar suas respostas. Eles podem fazer algumas perguntas de acompanhamento, mas depois lhe indicarão a direção de uma uma área em que você poderá fazer uma contribuição.

Encontre sua edição

Se você conversou com um membro da equipe Bee, ele provavelmente indicou uma parte do projeto BeeWare na qual você pode contribuir; ele pode até ter sugerido uma questão específica para você trabalhar. Se ele não indicou 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) manter 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 aprimorar o BeeWare. À medida que novos problemas são relatados, a equipe do Bee sinalizará alguns deles como problemas que são bem adequados para um colaborador iniciante - problemas que não exigem uma correção 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 tag "good first issue" para facilitar a localização.

Para filtrar uma lista de issues do GitHub pela etiqueta “good first issue”, siga estas etapas:

1. Clique no botão "Etiquetas" acima da lista de questões para ativar o menu suspenso.
2. Digite a palavra “bom” na caixa de pesquisa na parte superior do menu suspenso.
3. Clique em “boa primeira edição” na lista filtrada.

Filtrando as questões do GitHub pela etiqueta “boa primeira questão”.

Quando você encontrar uma questão que pareça interessante, leia todos os comentários sobre a postagem e poste um comentário na discussão dizendo que você está investigando o problema (por exemplo, "Looking into this at the PyCon US 2025"). O BeeWare não "atribui" explicitamente problemas - aceitamos aceitamos contribuições de qualquer pessoa. No entanto, em uma situação de sprint, precisamos garantir que não acabemos com duas pessoas trabalhando na mesma deixar um comentário é uma maneira leve de coordenar entre os colaboradores. colaboradores.

Se ainda não conseguir encontrar algo que gostaria de fazer, procure um membro da Bee Team e ele o ajudará a se concentrar em um problema específico.

Configurar um ambiente de desenvolvimento

Depois de encontrar um problema, você precisará configurar seu ambiente de desenvolvimento para poder trabalhar em uma correção. Cada projeto do BeeWare tem seu próprio guia de contribuição:

• Briefcase
• Toga
• Rubicon ObjC

Se o projeto não estiver nessa lista, verifique o LEIAME do projeto para obter detalhes do projeto para obter detalhes sobre como configurá-lo. Se alguma das instruções não fizer sentido (ou não conseguir encontrá-las), procure um membro da Bee Team e ele eles o ajudarão a se livrar do problema. E, se você 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 você pode começar a trabalhar em seu problema!

O que acontece depois que eu enviar minha solicitação de residência permanente?

Depois que você enviar sua pull request e ela for aprovada em todas as verificações automáticas, você estará pronto para uma revisão. todas as verificações automatizadas, você estará pronto para uma revisão. Informe a um membro da equipe principal saiba que você tem uma PR pronta para revisão, e eles darão uma dar uma olhada.

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

Assim que a PR for aprovada, seu revisor irá mesclá-la - e pronto! Parabéns - você contribuiu para o BeeWare! Se esta for sua primeira contribuição para o BeeWare, você também ganhou sua BeeWare Challenge Coin - procure um membro da equipe principal e ele lhe dará uma moeda!

Socorro! Estou preso!

Se você ficar preso em algum ponto do caminho, procure um membro da equipe Bee equipe. Não tenha medo de fazer qualquer pergunta. Se você estiver preso, nós queremos desbloqueá-lo. Se você 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 minha contribuição durante o sprint?

Sem problema! Você pode enviar uma contribuição a qualquer momento. Um dos objetivos dos sprints é incentivar e capacitar você a continuar contribuindo ao longo do resto do ano. A equipe Bee está disponível para ajudar em qualquer parte desse processo.

Se você já estava trabalhando em uma questão do GitHub ou enviou um PR, pode continuar a se 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 trabalhando com você!

Melhorando este guia

Se você tiver alguma sugestão sobre como melhorar este guia de sprint, informe-nos. O que funcionou para você? 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!