Cosa devo fare prima di aprire il sourcing di un progetto? [duplicare]

3

Sto pianificando l'apertura di un progetto a cui sto lavorando da un po 'e che penso possa giovare alla comunità. Ho già ripulito il codice, ho aggiunto una licenza ragionevole e ho scritto uno script di packaging che esegue i test unitari, ecc. (È Python, quindi significa setup.py). Ho scritto un README che descrive il progetto, le mie motivazioni per scrivere la libreria e le basi su come usarlo.

Cos'altro ci si aspetta da me? Lo sta ospitando su GitHub abbastanza o è previsto che mantenga anche i pacchetti PyPI? Che ne dici di testarlo con altre versioni di librerie (ho appena definito le dipendenze come le versioni che uso)? Quali sono alcuni aspetti carini che la gente apprezza davvero?

    
posta guidoism 21.08.2011 - 17:08
fonte

3 risposte

6

Sicuramente caricare su PyPi e tenerlo aggiornato, è davvero facile e non richiede molto sforzo. Dovrei essere in grado di utilizzare pip / easy_install per installare l'ultima versione stabile.

Aggiungere un README è un ottimo primo passo, ma avere un'ottima documentazione è ancora meglio, e per questo dovresti usare sphinx (nice tutorial qui ). Avere documentazione di qualità è fondamentale se vuoi che le persone utilizzino il tuo progetto.

    
risposta data 21.08.2011 - 17:47
fonte
4

Il mio consiglio è di leggere uno o più libri o siti web particolarmente mirati alla creazione di progetti open source. Ci sono molte cose che puoi imparare da persone che hanno già fatto ciò che vuoi fare.

Ad esempio, uno di questi libri è Producing Open Source Software di Karl Fogel. Questo è disponibile come ebook gratuito. Meglio della lettura, compra una copia per aiutare a supportare l'autore.

Dalla sezione "Chi dovrebbe leggere questo libro":

This book is meant for software developers and managers who are considering starting an open source project, or who have started one and are wondering what to do now. It should also be helpful for people who just want to participate in an open source project but have never done so before.

The reader need not be a programmer, but should know basic software engineering concepts such as source code, compilers, and patches.

Nel momento in cui scrivo questo, il libro ha le seguenti sezioni principali:

  1. Introduzione
  2. Guida introduttiva
  3. Infrastruttura tecnica
  4. Infrastruttura sociale e politica
  5. Denaro
  6. Comunicazioni
  7. Packaging, rilascio e sviluppo quotidiano
  8. Gestione dei volontari
  9. Governi e Open Source
  10. Licenza, copyright e brevetti
risposta data 21.08.2011 - 17:16
fonte
1

Se scrivi software per vivere, la società per cui lavori potrebbe sentirsi autorizzata a svolgere il proprio lavoro nel tempo (ragionevole) o nel tempo libero (discutibile). Dopo aver letto Proprietà intellettuale e Open Source: una guida pratica per proteggere il codice , ho capito che la scommessa più sicura è quella discuti questo progetto e il tuo desiderio di aprirlo con il tuo datore di lavoro. Anche se non hanno un problema nel rilasciare questo codice, è meglio sapere questo in anticipo che finire licenziato e essere citato in giudizio più tardi.

Una volta ottenuto il cenno del capo, la prima cosa che vorrai fare è concederla in licenza e quindi pubblicarla da qualche parte. Successivamente, puoi iniziare a rispondere ai nuovi utenti o ai tuoi desideri.

Sono arrivato ad apprezzare davvero un buon sistema di tracciamento dei biglietti (che Github ha) e una buona configurazione di test. Sia che si tratti di un host virtuale che di installare diverse versioni di dipendenze e di eseguire test manuali o test funzionali / unitari completamente automatizzati, è essenziale poter apportare una modifica e verificare che funzioni.

    
risposta data 21.08.2011 - 17:28
fonte

Leggi altre domande sui tag