O que devo fazer?

O melhor lugar para começar com qualquer contribuição de código aberto é com algo que se encaixe em seu conhecimento, experiência e área de interesse.

Antes de começar

Antes de começar a contribuir, pode ser útil ter uma ideia do projeto como um todo. Se você ainda não fez o [BeeWare Tutorial] (https://docs.beeware.org), comece por ele. Isso lhe dará exposição às ferramentas mais importantes do BeeWare, para que você possa ver como elas todas se encaixam.

Depois de concluir esse tutorial, você estará pronto para escolher algo para trabalhar. Se você teve algum problema ao fazer o tutorial - se encontrou um se encontrou um bug, ou se a linguagem usada para descrever uma etapa não estava clara - esse é um ótimo lugar para começar! Se você puder transformar sua experiência em uma melhoria no tutorial, a próxima pessoa que fizer o tutorial não terá o mesmo problema. terá o mesmo problema.

Entretanto, se sua experiência com o tutorial foi totalmente tranquila (e esperamos que tenha sido! que tenha sido!), aqui estão algumas ideias de onde se envolver, dependendo de suas habilidades e interesses.

Programação Python

Pasta

Se você quiser contribuir com uma ferramenta que tem um problema claramente definido, mas precisa de bugs claramente definido, mas que precisa de bugs eliminados e recursos adicionados, [Briefcase] (https://github.com/beeware/briefcase) pode ser o projeto ideal para você. você. O Briefcase é uma ferramenta para empacotar um projeto Python como um aplicativo aplicativo GUI autônomo. Ele recebe um arquivo de configuração pyproject.toml e usa esses dados de configuração para gerar instaladores ou pacotes de aplicativos ou pacotes de aplicativos distribuíveis.

The Briefcase [edição tracker] (https://github.com/beeware/briefcase/issues) tem uma coleção de sugestões de recursos (e um número menor de bugs). Se esta é sua primeira vez que estiver contribuindo, procure um dos tíquetes rotulados como good first issue - esses são problemas que foram escolhidos especificamente para contribuidores iniciantes colaboradores de primeira viagem porque devem ser relativamente simples de implementar. Você também pode achar útil filtrar os tíquetes para a plataforma que você realmente usa para desenvolvimento - será difícil corrigir um bug do Linux se você não tiver uma máquina Linux para usar nos testes!

Se quiser contribuir para um projeto específico, você também pode filtrar os bons primeiros problemas por projetos específicos usando estes links:

Escolha um tíquete, deixe um comentário dizendo que está analisando o problema e tente desenvolver um pull request implementando uma correção!

Programação de GUI

Se você tiver experiência com uma biblioteca de widgets nativa - Cocoa no macOS, GTK+ no Linux, Windows Forms, ou as bibliotecas nativas do iOS ou Android, talvez você possa ajudar com o Toga. O Toga é um kit de ferramentas de widgets para várias plataformas - ele fornece uma interface comum para elementos da interface do usuário, como botões e árvores.

A Toga tem uma série de interfaces já definidas; no entanto, a implementação dessas interfaces não está completa em todas as plataformas. Escolha um widget e implemente-o na plataforma de sua preferência!

Mesmo que você não conheça uma biblioteca de widgets nativa, talvez possa ajudar com o Toga. Escrever novos widgets é muito menos complicado do que pode parecer. Cada plataforma tem uma documentação sobre como usar suas APIs nativas, e o processo de tradução dessa APIs nativas, e o processo de traduzir a documentação dessa plataforma de outro idioma (por exemplo, o outra linguagem (por exemplo, Objective C ou C#) é um processo relativamente processo relativamente simples. O código existente deve lhe dar algumas dicas de como isso pode ser feito, e a equipe do BeeWare terá prazer em ajudar se você precisar. Entre no [BeeWare Discord] (/bee/chat/) e faremos o possível para ajudá-lo! possível para ajudar!

Even if you're not up for transforming code from one language to another, Toga's core library — as well as Travertino, a subpackage covering styling and layout — are pure Python, and platform-agnostic. Take a look at issues not tagged with a specific platform — many of them can probably be fixed with little or no change to any platform-specific code.

Documentação

Uma boa documentação é essencial para qualquer projeto bem-sucedido. Sabemos que Toga e Briefcase precisam de melhorias significativas melhorias significativas em sua documentação. Você já fez o tutorial; agora dê uma olhada na dê uma olhada na documentação do Toga e do Briefcase e veja se você consegue encontrar uma maneira de melhorar os tutoriais, as referências e os guias de tópicos que estão lá.

Tutoriais

Uma das melhores maneiras de contribuir é garantir que nossa documentação introdutória e documentação introdutória e de tutoriais seja sólida como uma rocha. Escolha um projeto de interesse da suíte da suíte BeeWare e tente seguir o guia de introdução e o tutorial. Se você não conseguir encontrar o guia de introdução, então essa é a a primeira coisa a ser informada!

À medida que você for trabalhando no tutorial, tome nota de tudo o que não faça sentido ou não funcione. Em seguida, abra um relatório de bug para esses problemas.

Windows

Se você é um usuário do Windows, o BeeWare pode definitivamente usar sua ajuda. A equipe principal do equipe principal usa Linux e macOS em seu desenvolvimento diário e, como resultado, é muito fácil que as incompatibilidades com o Windows apareçam. Isso é quase sempre devido a um descuido. Identificar - e talvez até problemas com a execução das ferramentas BeeWare no Windows é uma ajuda imensa. ajuda.

Idiomas

Você fala outro idioma além do inglês? No momento, a equipe principal é composta por falantes nativos de inglês. O fornecimento de traduções de documentação ou tutoriais ou guias completamente novos em seu idioma nativo idioma nativo é uma ótima maneira de contribuir. Escolha um projeto que já tenha documentação e traduza esse texto. Como alternativa, comece do zero e escreva um tutorial completamente novo.

Se você fala um idioma com um conjunto de caracteres não latinos (por exemplo, russo ou chinês), ou um idioma com escrita da direita para a esquerda (por exemplo, hebraico ou árabe), você poderá apontar todos os lugares em que assumimos a codificação ASCII simples ou convenções da esquerda para a direita. Escolha qualquer um dos projetos ativos do BeeWare e tente usá-lo em seu idioma nativo. idioma nativo. Se tiver algum problema, relate-o como um bug. se estiver se sentindo particularmente aventureiro, veja se consegue descobrir como corrigir o bug também.

Uso prático

Uma das melhores maneiras de determinarmos onde estão nossas lacunas - tanto na documentação e APIs - é que as pessoas realmente usem o BeeWare para criar algo. Portanto, se nenhuma das ideias apresentadas até agora parecer interessante, por que não tentar algo de sua autoria? Use a suíte BeeWare para criar aquele aplicativo que você sempre quis - uma visualização de desktop de uma fonte de dados ou um aplicativo móvel para aplicativo móvel para monitorar suas atividades - seja o que for, tente criá-lo.

Podemos quase garantir que você terá problemas. O BeeWare ainda é um projeto projeto muito novo. Mas os problemas que você encontrar nos darão uma ótima indicação do que precisa ser resolvido. Ele indicará quais widgets são necessários Precisamos de widgets e qual documentação precisa ser aprimorada. Portanto, à medida que você tiver problemas ao desenvolver seu próprio aplicativo, registre os problemas com os projetos BeeWare que causaram problemas. Isso nos permitirá identificar o que precisamos melhorar - e pode até ser uma fonte de inspiração para você contribuir!