= 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. [[PageOutline]] ---- == 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 [http://listas.brdesktop.org/cgi-bin/mailman/listinfo/devel lista de discussão onde é coordenado o processo de desenvolvimento do BrDesktop], envie um email para '''devel-request@listas.brdesktop.org''' 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 [wiki:FAQ 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/cdd/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 [/report consultar os tíquetes existentes] ou [/newticket 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 == [wiki:Recursos Aqui está uma página wiki com informações úteis para os desenvolvedores do projeto]. Se você quer ajudar a construí-la, [http://brdesktop.org/cdd/register 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.