Contribuir

Interessado em tornar o ghostwriter ainda melhor? Leia por favor as secções abaixo para saber como poderá contribuir.

Relatórios de Erros

Descobriu um erro? Por favor, comunique-o no gestor de erros do KDE. Não se esqueça de seguir as instruções de comunicação de erros! Mais importante, não se esqueça de incluir o número de versão do ghostwriter que está a usar.

Atenção: Ao não conseguir fornecer a informação necessária no modelo de relatório de erros, fará com que o mesmo seja automaticamente fechado.

Triagem de Erros

Poderá ajudar na triagem de erros no gestor de erros, reproduzindo os mesmo e obtendo mais informações para os comunicadores dos problemas terem uma ajuda acrescida onde reside o problema. O fecho de erros em duplicado e outros trabalhos burocráticos também é altamente valioso. Para mais informações, veja por favor as recomendações de triagem de erros.

Novas Funcionalidades e Correcções de Erros

Sabe como programar? Siga estes passos:

Submit an issue for your feature or bug on the KDE issue tracker.
Note: This step is necessary to ensure that the new feature meets the project goals or that the bug isn't really a feature. You will also want to coordinate what areas of code you will be updating to avoid merge conflicts in case someone else is working on that same area of code as well.
Depois de alguma discussão sobre o seu pedido novo, desenvolva a sua funcionalidade ou correcção de erros. Siga por favor o guia de estilo do código com as Plataformas do KDE. Importante: *Mantenha o seu código sempre focado no problema em questão. Alterações ao código não-relacionadas com o mesmo pertencem a erros/pedidos de reunião separados, de forma a tornar a revisão de código e os testes mais simples.
Submit a pull request against the master branch with your code updates.
Important: Please squash your commits in git before submitting the pull request!
Espere por uma breve revisão de código e que pelo menos outros dois voluntários testem a sua funcionalidade ou correcção de erros.
Faça as actualizações ao seu pedido junção, à medida que vá recebendo as reacções.
Assim que o seu pedido de junção seja aprovado por pelo menos dois voluntários de testes, o seu pedido de junção será então agregado.

Revisões de Código

Sabe programar e tem atenção aos detalhes? Voluntarie-se para rever os pedidos de junção de outros utilizadores!

Procure por um novo pedido de junção e adicione um comentário em como se oferece como voluntário para a revisão de código.
Submeta os comentários de revisão do código.
Espere pelas actualizações ao pedido de funcionalidade (se necessário).
Continue a dar as suas opiniões até que se sinta confiante com o código.
Deixe um comentário com a sua aprovação no pedido de junção.
Assim que pelo menos dois voluntários de testes submetam a sua aprovação, o pedido de junção será agregado.

Aqui estão algumas dicas do que deve verificar nas revisões de código:

O código submetido segue o guia de estilo de código com as Plataformas do KDE?
O código é legível e tem comentários que explicam as linhas menos óbvias?
O código é "pessimista"? Por outras palavras, ele verifica os valores inválidos antes de os usar e lidar com as possíveis condições de erro?
As comparações ou instruções múltiplas estão envolvidas entre parêntesis dentro das instruções 'if' para evitar problemas com a ordem das operações? Exemplos:
```
// Errado
if (a == b || c > d);

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

Os literais estão do lado esquerdo do operador == para evitar que os erros de escrita com o operador = passem despercebidos pelo compilador? Exemplos:

// Errado
if (variable == 1);

//         Razão: E se existir algum erro? O compilador não o irá apanhar!
if (variable = 1); // Ups!
// Certo
if (1 == variable);

//         Razão: Desta vez, o compilador irá detectar o erro.
if (1 = variable); // Ups!

Testes

Ofereça-se como voluntário para rever o código e testar novas funcionalidades e correcções de erros! Siga estes passos:

Consulte um novo pedido de junção e adicione um comentário em como se está a voluntariar para o testar.
Compile o pedido de junção na sua plataforma.
Teste a funcionalidade/correcção de erros e tente quebrá-la!
Dê as suas opiniões sobre os resultados dos testes no pedido de junção.
Espere pelas actualizações ao pedido de funcionalidade (se necessário).
Continue a testar e a dar as suas opiniões e reacções até que se sinta confiante que o código funcione.
Deixe um comentário com a sua aprovação no pedido de junção.
Assim que pelo menos outro voluntário de testes submeta a sua aprovação, o pedido de junção será aceite.

Traduções

Por favor pense em juntar-se à equipa de traduções do KDE para traduzir as suas aplicações favoritas para outras línguas.

Suporte Técnico

Tem conhecimentos sobre o Linux ou na compilação em MacOS? Sabe como corrigir um problema com que outras pessoas se deparam? Poderá ajudar a responder às questões dos utilizadores e na resolução de problemas no gestor de erros do KDE - será um esforço bastante reconhecido!