Código do site, entre outras coisas, da comunidade Django Brasil.
Contribuindo
Requisitos
- Conhecimento básico de Subversion (checkout, update, commit e capacidade de resolver conflitos);
- Conhecimentos básicos em desenvolvimento web com Python e Django;
- Desejável conhecimento de uso das ferramenta diff e patch.
Passo-a-passo
- Cadastre-se na lista de discussão da Django Brasil;
- Solicite, através da lista de discussão, a sua inclusão como membro do projeto. Assim, você poderá efetuar commits no repositório com a sua conta do Google;
- Assine o feed das atividades do projeto;
- Faça checkout do projeto e o configure (InstalacaoConfiguracao);
- Verifique as issues;
- Caso deseje contribuir com uma outra tarefa que não esteja nas issues, abra uma nova issue;
- Altere o status da issue para Started para informar aos outros colaboradores que está trabalhando nesta issue (volte pra Accepted caso tenha cancelado esta atividade);
- Altere os arquivos utilizando um editor de texto de sua preferência, efetuando commits que resolva uma issue de cada vez (informe qual issue o commit está relacionado, veja exemplos em Contribuindo);
- Feche a issue em questão alterando seu status para Fixed, não esqueça de informar em qual revisão ela foi finalizada (por exemplo: "Corrigido em r13" -- o Google cria ligações automaticamente utilizando este formato).
Lembre-se que o site é da comunidade e para a comunidade (principalmente). Discuta sempre antes de inserir um novo recurso no site, para ver se o mesmo é viável ou se é o momento certo para tal (nada o impede de realizar a tarefa em um branch ou localmente).
Obs.: é importante que uma nova issue que necessita de discussão tenha o status como New. Apenas marque para Accepted caso alcance um consenso (ou use o bom senso).
Equipe da Garantia da Qualidade (QA)
O trabalho de um membro da QA é basicamente:
- Verificar as issues finalizadas que precisam de aprovação;
- Conferir se a solução foi satisfatória ou não e avaliá-la pela revisão de código do Google Code, fazendo observações quando necessário;
- Mudar o status da issue para Verified se a solução poderá ser repassada ao branch online
- Fazer merge com o branch online com a solução, para ela ir ao ar.
Qualquer pessoa pode fazer o trabalho relacionado à equipe de QA desde que:
- Saiba o que está fazendo;
- Se sinta confiante;
- Não altere o status de uma issue para Verified se foi você quem a resolveu.
Acesse a página Contribuindo para mais informações.
Instalação/Configuração (Guia Rápido)
Download
svn checkout http://djangobrasil.googlecode.com/svn/trunk/ djangobrasil
Configuração
Acesse o diretório src/djangobrasil/ e digite o comando abaixo:
python manage.py syncdb
Preenchendo o banco de dados
Se deseja incluir no banco de dados um conteúdo de exemplo para o site, digite o comando abaixo no diretório src/djangobrasil/:
python manage.py loaddata aggregator blog comments flatpages redirects sites
Execução
Acesse o diretório src/djangobrasil/ e execute o seguinte comando:
python manage.py runserver
A página poderá ser acessada no endereço http://127.0.0.1:8000/.
Problemas!? Veja em mais detalhes na página Instalação/Configuração.
Contato
- Lista de discussão da Django Brasil: http://lista.djangobrasil.org
- Canal IRC: #django-br (rede Freenode, irc.freenode.net)
A lista de autores e seus respectivos e-mails, pode ser obtida no arquivo AUTHORS.