Contribuir

Interessado em tornar o ghostwriter ainda melhor? Leia as seções abaixo para ver como você pode contribuir.

Relatórios de bug

Encontrou um bug? Por favor, reporte-o no rastreador de problemas do KDE. Não se esqueça de seguir as diretrizes de reporte de problemas! Mais importante, não se esqueça de incluir o número da versão do ghostwriter que você está usando.

Aviso: A não apresentação das informações exigidas no modelo de relatório de bug resultará no fechamento automático do relatório de bug.

Triagem de bugs

Você pode ajudar na triagem de problemas no rastreador de problemas reproduzindo bugs e obtendo mais informações de relatores de bugs para ajudar a identificar onde o problema está. Fechar problemas duplicados e outras tarefas de limpeza também são apreciados. Para mais informações, consulte as diretrizes de triagem de bugs.

Novas funcionalidades e correções de bug

Você sabe programar? Siga estes passos:

Submeta um relatório para sua funcionalidade ou bug no Rastreador de problemas do KDE.
Observação: Esta etapa é necessária para garantir que a nova funcionalidade atenda aos objetivos do projeto ou que o bug não seja realmente uma funcionalidade. Você também deve coordenar quais áreas do código serão atualizadas para evitar conflitos de mesclagem caso outra pessoa esteja trabalhando na mesma área do código.
Após a discussão sobre o seu novo problema, codifique a funcionalidade ou a correção de bug. Siga o Guia de estilo de codificação do KDE Frameworks. Importante: Mantenha seu código focado no problema em questão. Alterações não relacionadas ao código pertencem a problemas/solicitações de mesclagem separados para facilitar a revisão e os testes de código.
Envie uma solicitação de pull para o branch master com suas atualizações de código.
Importante: Por favor, compacte seus commits no git antes de enviar a solicitação de pull!
Aguarde uma breve revisão do código e pelo menos dois outros voluntários para testar seu recurso ou correção de bug.
Faça atualizações em sua solicitação de pull conforme receber feedback.
Assim que sua solicitação de pull for aprovada por pelo menos dois outros testadores voluntários, sua solicitação de pull será mesclada.

Revisão de código

Você sabe programar e tem atenção aos detalhes? Ofereça-se para revisar novas solicitações de mesclagem de outros programadores!

Procure por uma nova solicitação de mesclagem e adicione um comentário informando que você está se voluntariando para revisar o código.
Envie comentários de revisão de código.
Aguarde atualizações na solicitação de mesclagem (se necessário).
Continue fornecendo feedback até ter certeza de que o código está correto.
Deixe um comentário com sua aprovação da solicitação de mesclagem.
Assim que pelo menos dois testadores voluntários enviarem sua aprovação, a solicitação de mesclagem será mesclada.

Aqui estão algumas dicas sobre o que procurar em revisões de código:

O código enviado segue o Guia de estilo de codificação do KDE Frameworks?
O código é legível, com comentários explicando quaisquer linhas não óbvias?
O código é "pessimista"? Em outras palavras, ele verifica se há valores inválidos antes de usá-los e lida com possíveis condições de erro?
Múltiplas comparações ou instruções são colocadas entre parênteses dentro de instruções if para evitar acidentes com a ordem das operações? Exemplos:
```
// Errado
if (a == b || c > d);

// Correto
if ((a == b) || (c > d));
```

Os literais estão à esquerda do operador == para evitar que um erro de digitação com o operador = escape à atenção do compilador? Exemplos:

// Errado
if (variable == 1);

//         Motivo: E se houver um erro de digitação? O compilador não vai detectá-lo!
if (variable = 1); // Oops!
// Correto
if (1 == variable);

//         Motivo: Desta vez o compilador detectará o erro de digitação.
if (1 = variable); // Oops!

Testando

Ofereça-se para revisar o código e testar novos recursos e correções de bugs! Siga estes passos:

Procure por uma nova solicitação de mesclagem e adicione um comentário informando que você está se voluntariando para testá-la.
Crie a solicitação de mesclagem na sua plataforma.
Teste o recurso/correção de bug e tente quebrá-lo!
Forneça feedback sobre os resultados dos testes na solicitação de mesclagem.
Aguarde atualizações na solicitação de mesclagem (se necessário).
Continue testando e fornecendo feedback até ter certeza de que o código está funcionando.
Deixe um comentário com sua aprovação da solicitação de mesclagem.
Assim que pelo menos um outro testador voluntário enviar sua aprovação, a solicitação de mesclagem será aceita.

Traduções

Considere entrar para a equipe de traduções do KDE para traduzir seus aplicativos favoritos para outros idiomas.

Suporte técnico

Você tem conhecimento sobre Linux ou desenvolvimento para MacOS? Sabe como resolver aquele problema que outros sempre enfrentam? Responder às perguntas dos usuários e solucionar problemas no rastreador de bugs do KDE seria muito apreciado!