Lista de verificação para iniciar um projeto de código aberto [fechado]

50

Para iniciar um projeto de código aberto não é apenas lançar o código-fonte em algum repositório público e, em seguida, estar feliz com isso. Você deve ter documentação técnica (além do usuário), informações sobre como contribuir, etc.

Se você cria uma lista de verificação sobre coisas importantes a fazer, o que incluiria nela?

    
por Anto 24.02.2011 / 19:24
fonte

2 respostas

34

O mais importante é:

  • use o projeto e coloque-o em um estado útil, onde você gosta de usá-lo. certifique-se de que o projeto funciona e é útil.

As coisas que eu coloquei nas primeiras prioridades são:

  • tem um simples "o que é isso?" Web site com links para algum fórum de discussão (seja email ou chat) e para o repositório de código-fonte
  • certifique-se de que o código compila e geralmente funciona, não faça correções de trabalho em andamento ou meio-asnadas no ramo principal que quebram as coisas, porque o trabalho de outras pessoas seria interrompido
  • insira um arquivo de licença no repositório de código com uma licença bem conhecida e marque o proprietário dos direitos autorais (provavelmente você ou sua empresa). não omita a licença, invente uma licença ou use uma licença obscura.
  • tenha instruções de como contribuir, digamos, em um arquivo de HACKING ou inclua em seu README. Isso deve incluir para onde enviar patches, como formatar patches, regras de recuo de código, quaisquer outras convenções importantes do projeto
  • tem instruções sobre como relatar um bug
  • seja útil na lista de discussão ou em quaisquer fóruns

Depois dessas prioridades, eu diria:

  • documentação (isso evita que você trabalhe na lista de discussão ... faça um FAQ a partir de suas listas é um começo simples)
  • tente fazer as coisas de uma maneira "normal" (não invente seu próprio sistema de compilação ou use algum estranho, não use um recuo de 1 espaço, não seja irritantemente peculiar em geral, porque ele adiciona curva de aprendizado )
  • promova seu projeto. Marketing marketing de marketing. Você precisa de alguns blogs e sites de notícias e coisas do tipo para cobrir você, e então, quando as pessoas aparecerem interessadas, você precisa conversar com elas e ter certeza de que elas funcionem e olhem para os patches delas. Talvez mencione seu projeto nos fóruns de projetos relacionados.
  • sempre revise e aceite os patches o mais rápido possível. Imediatamente é perfeito. Mais do que alguns dias e você está perdendo muita gente.
  • responda sempre ao e-mail sobre o projeto o mais rapidamente possível.
  • crie um ambiente acolhedor / positivo / divertido. Não seja um idiota. diga por favor e obrigado e distribua elogios. afugentar qualquer idiota que aparecer e começar a envenenar a comunidade. tente encontrar pessoas pessoalmente quando puder e formar laços.
por 24.02.2011 / 21:04
fonte
17

Para começar, Diminua a barreira para entrada , isso significa:

  • facilite a instalação,
  • facilite a modificação,
  • facilite a localização do seu projeto,
  • basta criar tudo o que você deseja para facilitar.

Como?

  • Dê uma resposta a todas as perguntas que você possa imaginar em sua documentação,
  • Crie um sistema de criação fácil de usar,
  • Limpe seu código, ninguém gosta de trabalhar com código de spaghetti,
  • Faça algo de que as pessoas precisam.
por 24.02.2011 / 20:09
fonte