Guia de contribuições¶

Existem várias maneiras de contribuir para BeeWare. Estes guias cobrem tudo o que precisa saber para oferecer a sua contribuição.

Utilizar IA e ferramentas autónomas

O Projeto BeeWare não incentiva nem proíbe o uso de ferramentas de IA na realização de contribuições. No entanto, caso utilize uma ferramenta de IA, exigimos que declare quais ferramentas foram utilizadas. Nossa Política de IA contém todos os detalhes sobre as suas obrigações.

O que posso fazer?¶

Corrigir um problema ¶

A contribuição mais óbvia que pode fazer é escrever código para corrigir um problema conhecido.

Implementar uma nova funcionalidade ¶

Esta a faltar em BeeWare uma funcionalidade que gostaria de ver? Pode implementar uma nova funcionalidade.

Escrever documentação ¶

Nenhuma funcionalidade está completa até que esteja bem documentada. Escrever documentação é uma forma de contribuir que não envolve escrever código.

Triagem a um problema ¶

Sempre que alguém reporta um novo problema, esse problema precisa duma primeira avaliação. A triagem a um problema envolve a recolha das informações fornecidas por quem o reportou e a tentativa de reproduzir o problema descrito.

Rever um pedido de puxar ¶

Depois de um pedido de puxar ser enviado, ele precisa ser revisto antes de ser fundido. Independentemente de estar ou não profundamente familiarizado com o conteúdo, é provável que haja uma maneira de ajudar na revisão de um pedido de puxar.

Sugerir uma nova funcionalidade ¶

Tem uma sugestão ou ideia para uma nova adição a uma das ferramentas do BeeWare? Pode propor uma nova funcionalidade para consideração.

Traduzir conteúdo ¶

O BeeWare mantém várias documentações em vários idiomas. Se conhece um idioma diferente do Inglês, pode ajudar com a tradução do conteúdo.

Usar as ferramentas ¶

Tem uma ideia para uma aplicação desenvolvida com o Toga? Tem uma aplicação existente que poderia ser empacotada com o Briefcase? Pode usar as ferramentas e fornecer informação de retorno sobre a sua experiência.

Como posso contribuir?¶

Configurar um ambiente de desenvolvimento ¶

Antes de começar a contribuir para o BeeWare, vai precisar de configurar o seu ambiente de desenvolvimento.

Reproduzir um problema ¶

Antes de corrigir um problema, vai precisar de verificar que ele existe. Reproduzir um problema também é uma parte importante da triagem.

Trabalhar a partir de um ramo ¶

Ao preparar-se para submeter uma contribuição, trabalhe a partir de um ramo sempre.

Evite o aumento do escopo ¶

É importante manter o foco e evitar aumentos de escopo com a sua contribuição.

Propor uma nova funcionalidade ¶

Vai seguir estes passos para propor uma nova funcionalidade.

Escrever, correr, e testar o código ¶

Para atualizar ou contribuir com código, vai precisar de escrever, executar, e testar o seu código.

Compilar a documentação ¶

Para atualizar ou contribuir com documentação, vai precisar de ser capaz de compilar os documentos.

Escrever documentação ¶

Para contribuir com a documentação, vai escrever novo conteúdo ou atualizar o conteúdo existente.

Adicionar uma nota de modificação ¶

Cada pedido de puxar deve ser acompanhado de uma nota de alteração.

Submeter um pedido de puxar ¶

Quando as suas alterações estiverem prontas, vai submeter um pedido de puxar para revisão.

Fornecer uma revisão ¶

Se sentir-se confortável, pode fazer uma revisão da contribuição de outra pessoa.

Traduzir conteúdo ¶

O BeeWare usa o Weblate para traduções, o que requer alguns passos para começar.

Submeter um novo problema ¶

Se deparar-se com um novo problema ou bug, é útil submeter um problema.

O que acontece depois?¶

Revisão do pedido de puxar ¶

Quando um pedido de puxar é submetido, o próximo passo a revisão do PR.

O processo de lançamento ¶

As contribuições fundidas vão passar pelo processo de lançamento.

Políticas¶

Política de IA ¶

Política da BeeWare sobre o uso de IA Generativa, grandes modelos de linguagem e outras ferramentas autónomas nas contribuições.

Guias de Estilo¶

Guia do estilo de código ¶

Estas são as diretrizes para contribuir com código para os projetos do BeeWare.

Guia do estilo de documentação ¶

Estas são as diretrizes para contribuir com documentação para os projetos do BeeWare.