Come posso coinvolgere meglio gli utenti che hanno recitato il mio progetto su GitHub?


19

Di recente ho realizzato un progetto, chiamato Hebel , su cui sto lavorando a GitHub. È un framework per il deep learning accelerato dalla GPU scritto in Python e Nvidia CUDA. L'ho pubblicato su Google+ e subito dopo è stato raccolto su Hacker News e per alcuni giorni è diventato leggermente virale. In seguito l'ho pubblicato di nuovo anche nel subreddit di Machine Learning e nel complesso il mio progetto ha raccolto 822 stelle e 47 forchette su GitHub, il che è stato davvero esaltante. 822 stelle significa che il mio progetto è tra i primi 200 progetti Python su GitHub e in effetti ha più stelle di alcuni progetti Python di alto profilo e ampiamente utilizzati come virtualenv.

Nonostante il notevole interesse per il mio progetto, sono molto deluso dall'impegno che ho visto finora. Nessuna delle 47 forchette dei miei progetti ha mai avuto alcun commit, non ho ricevuto alcuna richiesta pull e due persone hanno presentato solo tre numeri. Sembra che il mio progetto sia potenzialmente molto interessante per molte persone, ma lo ricoprono solo una volta o lo bucano una volta e poi non ci tornano più né lo usano su base continua.

Come posso migliorare il coinvolgimento in modo che gli utenti possano inviare bug o richieste di miglioramento o che i contributori possano inviare le modifiche?


5
È il tipo di progetto che molti considereranno interessante, ma in realtà non lo useranno da soli.
CodesInChaos

1
Immagino che la maggior parte delle persone stia recitando il tuo progetto come segnalibro perché, mentre sfogliando il file readme.md, leggono alcune parole d'ordine (Python, CUDA) che suonano alla grande con cui suonare in un secondo momento. Sono uno sviluppatore senior di software, ma anche dopo aver esaminato la pagina del tuo progetto github per un paio di minuti, ho solo una vaga idea di cosa si tratti. Se vuoi che le persone contribuiscano al tuo progetto, il mio consiglio - assolutamente non scientifico - lo presenterebbe in un modo che anche qualcuno che non sa molto delle reti neurali (e di tutte le altre cose esperte) può capire.
ssc,

Risposte:


25

Hai lavorato molto duramente su questo. Complimenti per tutta l'attenzione, ma mi dispiace che non sia coinvolgente.

La prima cosa che noto è che non ci sono problemi. Per far interagire le persone devi essere visibile nel loro feed di notizie GitHub. Quando si avvia un problema, verrà visualizzato per le persone che seguono il progetto (non quelle che lo hanno interpretato). Quindi la dimensione della tua community è di circa 80 follower. Sono solo i follower a cui dovresti pensare. I carrelli elevatori possono semplicemente afferrare il codice e andarsene, e le stelle sono come dei segnalibri. Un follower verrà informato di nuovi problemi.

Prova ad aprire alcuni problemi facili.

MODIFICARE:

README.md è la tua pubblicità per il repository. È la prima cosa che la gente leggerà e la prima cosa a cui si rivolgono per chiedere aiuto. 2/3 del tuo readme parla di cosa sia Hebel in un linguaggio tecnicamente specifico (cioè non ho idea di cosa tu stia parlando). Il 1/3 inferiore ha solo alcune istruzioni di installazione.

Una delle cose più difficili che ho trovato con GitHub è far sì che i progetti facciano realmente ciò che sostiene l'autore. L'installazione, l'esecuzione e il funzionamento richiedono più tempo. Se qualcuno ottiene il tuo repository ma non riesce a farlo funzionare, non riceverai mai una richiesta pull.

Posso solo sospettare che questa sia la causa.

Rivedi il tuo file Leggimi e metti le istruzioni per iniziare / installazione proprio in alto. Quindi le persone possono saltare subito dentro e andare avanti.

In secondo luogo, includere un tipo di esempio / esempio che possono essere eseguiti rapidamente e che dimostrano i vantaggi del progetto.


3
Nessun dubbio. Se hai una sezione nel README che assomiglia a "Contribuire: clonare il repository, eseguire questo script di compilazione su una riga, aggiungere una funzione, aggiungere un test, inviare un PR", quindi penso che farai molti progressi. Ci sono tonnellate di inerzia che saltano nel progetto di qualcun altro. Rendilo facile per loro!
Daniel J. Pritchett,
Utilizzando il nostro sito, riconosci di aver letto e compreso le nostre Informativa sui cookie e Informativa sulla privacy.
Licensed under cc by-sa 3.0 with attribution required.