Wie kann ich die Benutzer, die mein Projekt auf GitHub in der Hauptrolle gespielt haben, besser ansprechen?

19

Ich habe kürzlich ein Projekt mit dem Namen Hebel gestartet, an dem ich bei GitHub gearbeitet habe. Es ist ein in Python und Nvidia CUDA geschriebenes Framework für GPU-beschleunigtes Deep Learning . Ich habe darüber auf Google+ gepostet und bald darauf wurde es von Hacker News aufgegriffen und für ein paar Tage leicht viral. Ich habe später noch einmal darüber im Subreddit "Maschinelles Lernen" gepostet und insgesamt 822 Sterne und 47 Gabeln auf GitHub gesammelt, was wirklich berauschend war. 822 Sterne bedeuten, dass mein Projekt zu den Top 200 Python-Projekten auf GitHub gehört und tatsächlich mehr Sterne hat als einige hochkarätige und weit verbreitete Python-Projekte wie virtualenv.

Trotz des großen Interesses an meinem Projekt bin ich sehr enttäuscht von dem tatsächlichen Engagement, das ich bisher gesehen habe. Keine der 47 Gabeln meiner Projekte hatte jemals eine Zusage, ich habe keine Pull-Anfragen erhalten und nur drei eingereichte Ausgaben wurden von zwei Personen eingereicht. Es scheint, dass mein Projekt für viele Menschen möglicherweise sehr interessant ist, aber sie spielen es nur einmal in der Hauptrolle oder geben es ab und kehren dann nie wieder zurück oder verwenden es kontinuierlich.

Wie kann ich das Engagement verbessern, damit Benutzer entweder Fehler oder Verbesserungsvorschläge einreichen oder Mitwirkende Änderungen einreichen?

Oceanhug
quelle
5
Es ist die Art von Projekt, die viele für cool halten, die sie aber selbst nicht verwenden werden.
CodesInChaos
1
Ich würde vermuten, dass die meisten Leute Ihr Projekt als Lesezeichen markieren, weil sie beim Durchblättern der Datei readme.md einige Schlagworte (Python, CUDA) lesen, mit denen man später großartig spielen kann. Ich bin ein leitender Softwareentwickler, aber selbst nachdem ich ein paar Minuten auf Ihre Github-Projektseite geschaut habe, habe ich nur eine vage Vorstellung, worum es geht. Wenn Sie möchten, dass die Leute zu Ihrem Projekt beitragen, würde mein - völlig unwissenschaftlicher - Rat es so darstellen, dass jemand, der nicht viel über neuronale Netze (und all die anderen Experten) weiß, es auch verstehen kann.
ssc

Antworten:

25

Sie haben wirklich hart daran gearbeitet. Herzlichen Glückwunsch zu der ganzen Aufmerksamkeit, aber es tut mir leid, dass es nicht verlockend ist.

Das Erste, was mir auffällt, ist, dass es keine Probleme gibt. Um Leute zum Mitmachen zu bewegen, müssen Sie in ihrem GitHub-Newsfeed sichtbar sein. Wenn Sie ein Problem starten, wird es für die Personen angezeigt, die dem Projekt folgen (nicht für diejenigen, die es in der Hauptrolle gespielt haben). Deine Community-Größe beträgt also ungefähr 80 Follower. Es sind nur die Anhänger, über die Sie nachdenken sollten. Gabelstapler können einfach den Code nehmen und weggehen, und Sterne sind wie Lesezeichen. Ein Follower wird über neue Probleme informiert.

Versuchen Sie, einige einfache Probleme zu öffnen.

BEARBEITEN:

Ihre README.md ist Ihre Werbung für das Repo. Es ist das erste, was die Leute lesen werden, und das erste, an das sie sich wenden, um Hilfe zu erhalten. In 2/3 Ihrer Readme-Datei geht es darum, was Hebel in einer bestimmten Sprache ist (dh ich habe keine Ahnung, wovon Sie sprechen). Das untere Drittel enthält nur ein paar Installationsanweisungen.

Eines der schwierigsten Dinge, die ich bei GitHub gefunden habe, ist, Projekte dazu zu bringen, das zu tun, was der Autor behauptet. Die Installation, das Ausführen und der Einstieg in die Arbeit nehmen die meiste Zeit in Anspruch. Wenn jemand Ihr Repo bekommt, es aber nicht zum Laufen bringt, erhalten Sie nie eine Pull-Anfrage.

Ich kann nur vermuten, dass dies die Ursache ist.

Überarbeiten Sie Ihre Readme-Datei und setzen Sie die Anweisungen für den Einstieg und die Installation ganz oben. So können die Leute sofort einsteigen und loslegen.

Zweitens sollten Sie eine Art Beispiel / Beispiel beifügen, damit diese schnell zum Laufen kommen und die Vorteile des Projekts demonstrieren.

Reactgular
quelle
3
Ohne Zweifel. Wenn Sie einen Abschnitt in der README-Datei haben, der aussieht wie "Contributing: Klonen Sie das Repo, führen Sie dieses einzeilige Build-Skript aus, fügen Sie ein Feature hinzu, fügen Sie einen Test hinzu, reichen Sie eine PR ein", dann werden Sie vermutlich große Fortschritte erzielen. Es gibt Unmengen von Trägheit, die in das Projekt eines anderen springen. Mach es ihnen einfach!
Daniel J. Pritchett