Quali sono le migliori pratiche per il rilascio di un progetto open source? [chiuso]

Question

Abbiamo un quadro po web piuttosto fresco che abbiamo usato con successo su decine di progetti dei clienti. Stiamo progettando di rilasciare questo software per la comunità. Tuttavia, sto torcendosi le mani su ciò che dovrebbe / dovrebbero, non andare su una nuova pagina del progetto di software open source. Quali sono le cose che il sito deve avere? Documenti? Un Wiki? Un link per scaricare? Che altro?

E, una questione connessa, ma forse diverso è come facciamo noi cominciamo la marcatura numeri di rilascio. Tutti usiamo internamente è il timbro SVN. C'è un buon modo per determinare quando iniziare a chiamare qualcosa versione 0.9 rispetto a 1.0 e 1.1 e così via?

Answer 1

È possibile avere un'idea di ciò che è necessario da ciò che i siti che ospitano progetto open source forniscono:

• Un sito web che funge da "sportello unico" per il progetto
• Documenti, potenzialmente in forma wiki
• Un repository di origine che consente la navigazione, checkout anonimo, e si impegna autenticati e autorizzati
• Issue Tracking e nuove richieste di funzionalità

Per quanto riguarda i numeri di versione ... non credo che chiunque ha funzionato il modo migliore di farlo ancora :) Con un minimo di pensiero, mi piacerebbe prendere in considerazione:

• v1.0 dovrebbe essere pronto per l'uso in produzione
• I maggiori cambiamenti numero di versione può perdere completamente la compatibilità all'indietro (se necessario - a malapena un obiettivo però)
• Minori cambiamenti numero di versione dovrebbe essere di solito per lo più compatibili - ironico è probabilmente migliore di rimuovere / rinominare bit di API
• cambiamenti numero di versione piccolo-che-minor dovrebbero includere solo aggiunte minori funzionali (se presente) e bug fix / prestazioni

Answer 2

Il controllo delle versioni, penso che il posto migliore in assoluto per iniziare da Semantic Versioning .

Answer 3

Il 0.9 / 1.0 / 1.1 / 1.0.1 / ... versione etichettatura è a scopo di marketing (nel senso buono di esso). Questo consente agli utenti / clienti di identificare se il rilascio è maggiore, minore o bug-fix e se si considera che matura o non ancora.

Il minimo per consegnare è fonti. Altri risultati finali dipendono da quanto si è disposti ad aiutare gli utenti e fornire loro un sostegno.

Answer 4

Scegli un sito web per ospitare la sorgente prima (SourceForge, per esempio). Prendi la fonte lassù su un sistema di controllo della versione con checkout anonimo. Ottenere un indirizzo email in là per le persone a contatto con voi.

Chiama questa prima versione 0.1. Questo perché non si dispone ancora docs per sostenere il progetto.

Poi respirare.

Poi, iniziare a guardare la documentazione, come un wiki. Una volta che hai tutto coperto, a livello di base di dettagli, e si ritiene che il rilascio è pronto per un po 'in prima serata, per poi passare a 1,0, e iniziare a fornire download di binari.

Answer 5

Assicurati che ci pensi la licenza per le fonti.

Quando guardo un progetto open source, una delle prime cose che ho controllare è la licenza. Se la licenza non è GPL2 / GPL3 / BSD stili o simile, che è una demotivator per me.

La licenza significa che quello che la gente fare con esso, come si può crescere, e quanto è di proprietà della aziendale che ha rilasciato esso. Come scegliendo open source cerco di non dipendere da società (che dipendono da loro azionisti), ho davvero scegliere di utilizzare il software che è veramente libero.

Mentre la comunità open source è molto sensibile al potere aziendale (Google sembra un po 'immune a che, al momento), in modo da realmente necessario assicurarsi di consegnare il messaggio di veramente libero sul web sito e altri materiali si rilascia sul software.

Vedere più in software libero e definizioni open source della FSF.

Answer 6

Date un'occhiata a GitHub o Google Code. essi forniscono un ottimo punto di partenza per progetti open source. Si può descrivere il vostro progetto, documentate in un wiki, usare git o SVN repository, e fornire downloads insieme ad un monitoraggio emissione e gestione multi-sviluppatore. Nizza ambienti fuori dalla scatola da cui imparare e di utilizzarle.

Per i numeri di rilascio: Non consiglio 0,9 o qualcosa di simile per pre-rilascio. La ragione? Che dire di rilascio 1.9? È la sub-release 9 del major release 1 o è l'ultima pre-release di rilascio 2? Il mio standard di rilascio è di misura descritto qui: http://code.google.com/p / Tideland-EAS / wiki / ReleaseStandard . Io sto usando un numero di tre-schema, maggiore, minore, e fissare, insieme con un codice di stato, alfa, beta, gamma, e la data di uscita. Quindi sono in grado di gestire più versioni in parallelo con facilità.

Spero che questo aiuti.

mue