atencao devida a este tipo de documentacao tao primaria. Porem isso nao nos exime de escreve-la, com pelo menos as informacoes gerais do projeto e as instrucoes de setup para que ele seja facilmente configurado e executado por qualquer desenvolvedor.Um ponto para o Github: o README e mostrado na pagina principal do projeto, o que melhora bastante sua exposicao e aumenta a probabilidade de ele ser lido por novos desenvolvedores ao baixar o projeto.Vale notar tambem que este arquivo pode ser escrito usando linguagens de marcacao como o markdown e o textile, melhorando ainda mais a sua apresentacao e legibilidade.Colocada a importancia de fornecer um arquivo README, visite a pagina inicial do projeto e avalie voce mesmo o quanto essas instrucoes podem ser uteis ao clonar um projeto.Documentacao executavelUm fato interessante que comumente ocorre ao escrever um README e perceber que varios passos de setup inicial podem ser facilmente automatizados em arquivos de script. Foi exatamente o que aconteceu enquanto documentei o setup deste projeto: o README deu origem ao arquivo setup-project, que pode ser executado com o comando:source ~/App-Contatos-Rails/setup-projectAo final, este exercicio de documentacao levou tambem o beneficio da automatizacao :-) Adicionando o projeto Django no GithubClonando o projeto Similarmente como ocorreu ao clonar o projeto Rails em uma outra maquina (que nao tinha o RVM instalado), ao entrar no diretorio do projeto, nao ocorreu o carregamento automatico do VirtualEnv configurado no arquivo .rvmrc.As instrucoes de setup - para instalacao do RVM e do VirtualEnv - tambem foram documentadas num README, cujas instrucoes foram facilmente aproveitadas para a criacao de um script setup-project: O arquivo .gitignore em projetos DjangoA medida que vamos trabalhando na aplicacao, sao gerados alguns arquivos que nao precisamos versionar no Git. Por exemplo, os arquivos compilados do python (*.pyc) e o arquivo do banco de dados sqlite local. Para evitar que estes arquivos sejam submetidos para o Git, podemos adicionar um arquivo .gitignore ao projeto: Nota: Em aplicacoes Rails, este arquivo e gerado junto com a criacao da aplicacao. Isso pode ser notado na listagem do inicio deste post que mostra o commit inicial do projeto, com o arquivo .gitignore ja presente.Apesar de esta versao inicial estar bem simples, novas adicoes podem ser feitas todas as vezes que se perceber que um diretorio ou um padrao de arquivos nao precisa ser controlado pelo Git.Procurando no Google por palavras chave [Django .gitignore] sao listados varios exemplos de arquivos .gitignore mais abrangentes - para este post, prefiro manter as coisas simples.Caso ja tenha comitado arquivos indesejados para o Git, alem de adicionar o padrao no arquivo .gitignore, e necessario tambem remover os arquivos comitados - nada que nao poassa ser resolvido com o git rm.Consideracoes FinaisAo iniciar um projeto, e muito importante coloca-lo o mais cedo possivel num repositorio de controle de versao. Sao inumeros os beneficios: backup, versionamento desde as primeiras versoes, compartilhamento, e geracao da documentacao minima necessaria para que o projeto seja facilmente configuravel e acessivel para outros desenvolvedores, pra citar alguns.