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ê tenha tem] (/contribuição/primeira vez/síndrome do impostor/). Em sprints anteriores, mesclamos contribuições de pessoas com todos os níveis de experiência - estudantes do ensino médio estudantes do ensino médio, recém-formados em bootcamp, pessoas que não se consideram se consideram programadores e desenvolvedores experientes. Não importa 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í.
**Você já usou o BeeWare antes?
Se você ainda não o fez, comece a trabalhar no [BeeWare Tutorial] (https://docs.beeware.org/en/latest/). Ele lhe dará uma introdução sobre o que é o projeto BeeWare e como as peças do do projeto se encaixam. Se você tiver algum problema ao fazer o tutorial, faça anotações, pois garantir que ninguém mais tenha o mesmo é um ótimo tópico para uma primeira contribuição!
Quando você tiver concluído o tutorial até pelo menos a etapa 4, passe para a a próxima pergunta.
**Que equipamento de computação você tem consigo?
O equipamento que você tem com você impõe limites práticos ao que você pode contribuir. Por exemplo, se você tiver um laptop com Windows, não poderá não poderá trabalhar em nada relacionado ao iOS. Seu laptop executa Windows, macOS, Linux ou outra coisa? Seu telefone é é um dispositivo iOS ou Android? Seus dispositivos foram fornecidos por seu empregador ou são seus próprios dispositivos pessoais?
**Quanta experiência você tem em escrever código Python?
Você é novo em programação? Um veterano em Python? Um veterano em programação que começou a aprender Python há pouco tempo? Um recém-formado de um programa de bootcamp? Queremos encontrar um problema que seja uma boa combinação para seu nível de experiência.
Are you familiar with GitHub contribution processes?
Você usa o GitHub (ou um site de compartilhamento de código semelhante) para hospedar seu seu próprio código ou para contribuir com projetos de outras pessoas? Você sabe o que é CI (integração contínua)? Você já contribuiu para um projeto que tenha ganchos de pré-compromisso? Se eu lhe pedisse para "rebasear seu PR em relação ao main", você saberia o que fazer?
**Você já contribuiu para um projeto de código aberto antes?
Have you attended a sprint in the past? Have you ever submitted a PR (pull request) to an Open Source project? Are you familiar with how to use GitHub to create a pull request?
**Você tem alguma outra habilidade especial que possa ser útil?
Are you familiar with a GUI API (such as WinForms, Cocoa, or GTK)? Do you have deep knowledge of the internals of a particular operating system? Are you an expert in a programming language other than Python? If you don't have any special skills, that's not a problem - but if we've got a Windows Guru on our hands, we want to make sure those skills are being put to good use.
**Por que você se juntou a nós e no que está interessado?
"Você me pareceu um projeto amigável" é uma resposta perfeitamente adequada. No entanto, se houver mais motivos para você se juntar a nós hoje, informe-nos. Você está interessado em desenvolvimento móvel ou de desktop? Embalagens? 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? 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 seu problema
Se você conversou com um membro da equipe do Bee, ele provavelmente indicou uma parte do projeto BeeWare com a qual você pode contribuir. para uma parte do projeto BeeWare com a qual você pode contribuir. pode até ter sugerido um problema específico para você trabalhar. Se não tiverem se eles não lhe deram um problema específico, provavelmente indicaram os "Good First Issues" 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 problemas do GitHub pelo rótulo "bom primeiro problema", siga estas etapas:
- Clique no botão "Labels" (Rótulos) acima da lista de problemas para ativar o menu suspenso. o menu suspenso.
- Digite a palavra "good" na caixa de pesquisa na parte superior do menu suspenso menu suspenso.
- Clique em "good first issue" na lista filtrada.
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:
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 RP?
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.
Depois que o PR for aprovado na revisão, seu revisor mesclará o PR - e pronto! pronto! Parabéns - você contribuiu com o BeeWare! Se esta for sua primeira contribuição ao BeeWare, você também ganhou sua BeeWare Challenge Coin - encontre um membro da equipe principal do equipe principal e eles lhe darão uma moeda!
Ajuda! 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.
What if I don't complete my contribution during the sprint?
No problem! You can submit a contribution at any time. A goal of the sprints is to encourage and empower you to continue contributing throughout the rest of the year. The Bee Team are available to help with any part of this process.
If you were already working on a GitHub issue or submitted a PR, you can continue to communicate through GitHub. If you have other questions or need real-time help, the best place to find us is the BeeWare Discord server. We're looking forward to continuing to work with you!