Quais são as melhores práticas para lançar um projeto open source? [fechadas]

Question

Temos um framework web fresco pouco bonita que temos utilizado com sucesso em dezenas de projetos de clientes. Estamos planejando lançar este software para a comunidade. No entanto, estou torcendo as mãos sobre o que deve / deveria, e não ir em uma nova página projeto de software de fonte aberta. Quais são as coisas que o site deve ter? Docs? A Wiki? Um link para download? O que mais?

E, uma questão relacionada mas possivelmente diferente é como é que vamos começar a marcação números de versão. Todos nós usamos internamente é o selo SVN. Existe uma boa maneira de determinar quando começar a chamar algo versão 0.9 contra 1.0 e 1.1 e assim-on?

Answer 1

Você pode ter uma idéia do que é exigido por aquilo projeto open source sites de hospedagem fornecer:

• Um web site que atua como o "balcão único" para o projeto
• Docs, potencialmente em forma wiki
• Um repositório de origem permitindo a navegação, check out anônimo e autenticado e commits autorizados
• acompanhamento de problemas e novas solicitações de recursos

Como para números de versão ... Eu não acho que de ninguém funcionou a melhor maneira de fazer isso ainda :) Com um mínimo de pensamento, eu consideraria:

• v1.0 deve estar pronto para uso em produção
• número de versão principal alterações de compatibilidade podem perder completamente para trás (se necessário - dificilmente um objetivo embora)
• Menor número de versão muda geralmente deve ser principalmente compatível - depreciativo é provavelmente melhor do que remover / renomear pedaços de API
• menor do que o menor mudanças número da versão deve incluir apenas pequenas adições funcionais (se houver) e bug / correções de desempenho

Answer 2

Em versões, acho que o melhor lugar para começar a partir é Semântica Versioning .

Answer 3

A 0,9 / 1,0 / 1,1 / 1.0.1 / ... versão rotulagem é para fins de comercialização só (no bom sentido dele). Isso permite que seus usuários / clientes para identificar se a liberação é maior, menor ou de correção de bugs e se você considerá-lo amadurecer ou não ainda.

O mínimo para entregar é fontes. Outros resultados dependem de como você está disposto a ajudar seus usuários e proporcionar-lhes apoio.

Answer 4

Escolha um site para hospedar a fonte no primeiro (SourceForge, por exemplo). Obter a fonte lá em cima em um sistema de controle de versão com check out anônimo. Obter um endereço de e-mail lá para as pessoas em contato com você.

Chamada esta primeira versão 0.1. Isto é porque você não tem docs ainda para apoiar o projeto.

Então respirar.

Em seguida, começar a olhar para a documentação, como um wiki. Uma vez que você tem tudo coberto, em um nível básico de detalhes, e você acredita que o lançamento está pronto para algum horário nobre, em seguida, passar para 1,0, e iniciar a prestação de downloads binários.

Answer 5

Certifique-se de que você pensa sobre a licença para as fontes.

Quando eu olho para um projeto open source, uma das primeiras coisas que eu verificar é a licença. Se a licença não é GPL2 / GPL3 / estilos BSD ou similares, isso é um motivador para mim.

Os meios de licença que as pessoas vão fazer com ele, como ele pode crescer, e quanto ele é de propriedade do corporativa que lançou ele. Como escolhendo open source Eu tento não depender de corporações (que dependem de seus acionistas), eu realmente optar por usar o software que é realmente livre.

Como a comunidade open source é muito sensível ao poder corporativo (Google parece um imunológico pouco para que no momento), então você realmente deve certificar-se para entregar a mensagem de verdadeiramente livre em seu web local e outros materiais que você lançar sobre o software.

Veja mais no e código aberto definições da FSF.

Answer 6

Dê uma olhada no GitHub ou Google Code. eles fornecem um bom ponto de partida para próprios projetos de código aberto. Você pode descrever seu projeto, documentate em um wiki, git uso ou svn como o repositório, e fornecer downloads juntamente com um acompanhamento de problemas e gestão multi-desenvolvedor. Agradáveis ??ambientes fora da caixa para aprender e usá-los.

Para números de versão: Eu não recomendo 0,9 ou algo assim para pré-lançamentos. O motivo? E quanto a versão 1.9? É a sub-release 9º do grande lançamento 1 ou é o último pré-lançamento do Release 2? Meu padrão de liberação é descrito aqui: http://code.google.com/p / tideland-EAS / wiki / ReleaseStandard . Eu estou usando um três-número-esquema, maior, menor, e correção, juntamente com um código de status, alfa, beta, gama e a data de lançamento. Então, eu sou capaz de lidar com vários lançamentos em paralelo com facilidade.

Espero que isso ajude.

mue