Jak lepiej zaangażować użytkowników, którzy oznaczyli mój projekt GitHub?

19

Niedawno stworzyłem projekt o nazwie Hebel , nad którym pracowałem w GitHub. Jest to struktura przyspieszonego uczenia się za pomocą GPU napisana w Pythonie i Nvidii CUDA. Napisałem o tym w Google+, a wkrótce potem został on odebrany w Hacker News i stał się nieco wirusowy przez kilka dni. Później napisałem o tym ponownie w subreddicie Machine Learning i w sumie mój projekt zebrał 822 gwiazdki i 47 widelców na GitHub, co było naprawdę ekscytujące. 822 gwiazdki oznacza, że ​​mój projekt znajduje się w 200 najlepszych projektach Pythona na GitHub i faktycznie ma więcej gwiazdek niż niektóre głośne i szeroko stosowane projekty w Pythonie, takie jak virtualenv.

Pomimo dużego zainteresowania moim projektem, jestem bardzo rozczarowany faktycznym zaangażowaniem, które do tej pory widziałem. Żaden z 47 rozwidleń moich projektów nigdy nie miał żadnych zobowiązań, nie otrzymałem żadnych wniosków ściągania, a tylko trzy zgłoszone problemy zostały przesłane przez dwie osoby. Wydaje się, że mój projekt jest potencjalnie bardzo interesujący dla wielu osób, ale tylko raz go rozwidlają lub rozwidlają, a potem nigdy więcej do niego nie wracają ani nie używają go w sposób ciągły.

Jak mogę zwiększyć zaangażowanie, aby użytkownicy mogli zgłaszać błędy lub prośby o ulepszenie, albo aby autorzy zgłaszali zmiany?

oceanhug
źródło
5
Jest to projekt, który wielu uzna za fajny, ale sam go nie wykorzysta.
CodesInChaos
1
Sądzę, że większość ludzi uważa Twój projekt za zakładkę, ponieważ przeglądając readme.md, czytają kilka modnych słów (Python, CUDA), które brzmią wspaniale do zabawy na późniejszym etapie. Jestem starszym programistą, ale nawet po kilku minutach patrzenia na twoją stronę projektu github, mam tylko niejasne pojęcie o co w tym wszystkim chodzi. Jeśli chcesz, aby ludzie wnieśli swój wkład w twój projekt, moja - całkowicie nienaukowa - rada byłaby obecna w sposób, który zrozumie ktoś, kto nie wie dużo o sieciach neuronowych (i wszystkich innych rzeczach ekspertów).
ssc

Odpowiedzi:

25

Naprawdę ciężko nad tym pracowałeś. Gratulujemy całej uwagi, ale przepraszam, że to nie angażuje.

Pierwszą rzeczą, którą zauważam, jest to, że nie ma problemów. Aby zaangażować ludzi, musisz być widoczny w kanale wiadomości GitHub. Po uruchomieniu problemu pojawi się on dla osób śledzących projekt (nie dla tych, którzy go oznaczyli). Twoja społeczność liczy około 80 obserwujących. To tylko obserwujący, o których powinieneś pomyśleć. Widelce mogą po prostu złapać kod i odejść, a gwiazdy są jak zakładki. Obserwujący zostanie powiadomiony o nowych problemach.

Spróbuj otworzyć kilka prostych problemów.

EDYTOWAĆ:

Twój plik README.md to Twoja reklama repozytorium. To pierwsza rzecz, którą ludzie przeczytają, i pierwsza rzecz, do której zwracają się o pomoc. 2/3 twojego readme mówi o tym, czym jest hebrajski w języku technicznie specyficznym (tzn. Nie mam pojęcia o czym mówisz). Dolna 1/3 ma tylko kilka instrukcji instalacji.

Jedną z najtrudniejszych rzeczy, które znalazłem w GitHub, jest nakłanianie projektów do robienia tego, co twierdzi autor. Zainstalowanie, uruchomienie i rozpoczęcie pracy zajmuje najwięcej czasu. Jeśli ktoś otrzyma Twoje repozytorium, ale nie będzie w stanie sprawić, by działało, nigdy nie otrzymasz prośby o wycofanie.

Mogę tylko podejrzewać, że to jest przyczyna.

Popraw plik Readme i umieść instrukcje dotyczące rozpoczęcia / instalacji na górze. Aby ludzie mogli wskoczyć i zacząć.

Po drugie, dołącz jakiś przykład / przykład, który mogą szybko uruchomić, pokazujący korzyści płynące z projektu.

Reactgular
źródło
3
Bez wątpienia. Jeśli masz w README sekcję, która wygląda jak: „Współuczestnictwo: klonowanie repozytorium, uruchom ten jednowierszowy skrypt kompilacji, dodaj funkcję, dodaj test, prześlij PR”, to myślę, że zrobisz duży postęp. Mnóstwo bezwładności przeskakuje w czyimś projekcie. Ułatw im to!
Daniel J. Pritchett,