Desenvolvimento

Participe!

O BrDesktop é desenvolvido e mantido por desenvolvedores e usuários brasileiros. O processo de desenvolvimento é coordenado através da Internet. Utilizamos uma lista de discussão e um canal IRC que podem ser acessados por qualquer pessoa interessada em colaborar. Continue lendo abaixo se você quer participar desta comunidade.


Por que devo participar?

Uma das principal motivações de participantes de projetos de software livre é a troca de conhecimentos. Participar de um projeto como o BrDesktop envolve aprendizado, ensino, amizade, ética, hackerismo e o prazer de ver um produto colaborativo sendo útil para milhares de pessoas. Se pessoalmente é gratificante, profissionalmente é extremamente útil.

O Debian desenvolve tecnologia de ponta utilizada nas principais distribuições GNU/Linux, desde sistemas embarcados até mainframes de grande porte. Participar do BrDesktop é uma forma de começar a entender como funciona uma das maiores referências em projetos colaborativos do planeta, que é o Debian.

Como começar

Não é necessário ser desenvolvedor ou usuário avançado para começar colaborar com o BrDesktop. A melhor maneira de começar a colaborar com o projeto é simplesmente usar o sistema e reportar o que houver de errado nele. Se você tiver alguma habilidade específica, pode ajudar no desenvolvimento, na arte, na manutenção do site, etc. No entanto, para qualquer situação o primeiro passo é se inscrever na lista de discussão e se apresentar para os atuais participantes. Veja abaixo como inscrever-se na lista.

Canais de comunicação

Para participar da lista de discussão onde é coordenado o processo de desenvolvimento do BrDesktop, envie um email para devel-request@… com a palavra subscribe no assunto. Você receberá um email que deverá ser simplesmente respondido para confirmar a sua inscrição.

Você pode também acessar o canal IRC de desenvolvimento do BrDesktop #brdesktop no servidor irc.debian.org

Colabore na documentação

Ajudar a documentação do projeto é uma ótima maneira de aprender e colaborar. Os usuários que já estão confortáveis diante do BrDesktop podem documentar suas experiências e enviar para a lista de discussão do projeto, para posterior inserção na nossa seção de Perguntas Frequentes. Se você ainda não está pronto para escrever, você pode ajudar revisando o conteúdo durante as suas consultas e relatando qualquer erro para a lista de discussão.

Baixando o código fonte e programando

Para baixar os códigos-fonte do que é mantido pelo projeto, você precisa ter o pacote subversion instalado em seu computador. O Subversion é a ferramenta de controle de versões utilizada pela equipe do BrDesktop. Para instalá-lo execute o comando abaixo:

# aptitude install subversion

Após certificar-se que você tem o subversion instalado, basta fazer o checkout utilizando o comando abaixo:

svn co https://brdesktop.org/svn/trunk/

Identificando qualquer erro, você pode gerar um patch, e enviando para a lista de discussão do projeto, para um dos desenvolvedores aplicá-lo. Para gerar um patch use o comando abaixo:

$ svn diff > meu-patch.patch

É possível também navegar nos fontes, sem necessitar baixá-los, a partir do endereço:

http://brdesktop.org/browser

Reportando problemas de maneira eficiente

Uma das colaborações mais importantes para o projeto é quando os seus usuários relatam os problemas encontrados na utilização do BrDesktop, e até mesmo no site.. Isso pode ser feito a partir do sistema de tickets disponível para usuários cadastrados no site. O cadastro é rápido e simples e pode ser feito a partir de:

http://brdesktop.org/cdd/register

Antes de começar a utilizar o sistema de tickets do BrDesktop leia atentamente as instruções abaixo:

   1- Ao preencher um ticket de relato de bug deve-se sempre procurar ser o mais descritivo possível, 
         fornecendo a maior quantidade possível de detalhes sobre o problema.
   2- Tenha em mente que um relato de bug mal escrito pode fazer com que os desenvolvedores não 
         entendam o que você escreveu e acabem simplesmente fechando o bug como inválido.
   3- Lembre-se de fornecer um endereço de e-mail válido, pois alguns bugs pracisam de um "feedback"
         da pessoa que reportou o problema.
   4- Tickets com mais de 30 dias sem uma resposta serão fechados.
   5- Caso o bug que você esteja relatando possa ser reproduzível, por favor, liste os passos 
         necessários para reproduzí-lo.

Regras básicas para preenchimento de um ticket de relato de bug de maneira correta:

    * No primeiro campo informe seu e-mail ou, caso seja um desenvolvedor já cadastrado, seu login. 
         Relatos anônimos são aceitos porém é preferivel que eles sejam identificados pois permitem o 
         contato da equipe de desenvolvimento com quem relatou o bug.
    * Logo depois coloque um resumo sobre o que se trata o bug.
    * Em seguida forneça uma descrição detalhada. Procure fornecer o máximo de detalhes possíveis, 
         tendo em mente o que foi citado antes.
    * Nas propriedades do ticket (Ticket Properties) preencha da seguinte forma:

          * Component: escolha a qual seção do BrDesktop este problema está relacionado. 
                       Caso não saiba especifique o valor 'outro'.
          * Version: informe em qual versão do BrDesktop este problema ocorreu. Este campo
                     é muito importante pois é através dele que sabemos em qual versão ele 
                     ocorre direcionando sua solução.
          o Severity: diga a severidade deste bug. Caso não saiba responder informe 'normal'.
          o Keywords: forneça algumas palavras-chaves para serem utilizadas pelo mecanismo de busca.
          o Priority: a prioridade com que este bug deve ser resolvido. Deixe em normal, pois a equipe
                      de desenvolvimento atribuirá a prioridade correta.
          o Milestone: deixe em branco. A equipe de desenvolvimento preencherá adequadamente.
          o Assing to: deixe em branco também. Posteriormente a equipe de desenvolvimento vai 
                       atribuir este 
                       bug para algum integrante.
          o Cc: forneça seu e-mail. 

Depois de ler as instruções, você pode consultar os tíquetes existentes ou criar um novo tíquete.

Equipe

Atualmente a equipe do BrDesktop é composta pelas seguintes pessoas:

Nome Função
XXX Coordenação
YYY Sysadmin, QA
WWW Arte, Website
ZZZ Documentação

Recursos para desenvolvedores

Aqui está uma página wiki com informações úteis para os desenvolvedores do projeto. Se você quer ajudar a construí-la, registre-se no site e envie um email para a lista de desenvolvimento do BrDesktop pedindo que os administradores do site liberem seu acesso para edição.