Làm cách nào để thu hút người dùng tham gia dự án của tôi trên GitHub tốt hơn?


19

Gần đây tôi đã đưa ra một dự án, được gọi là Hebel , mà tôi đã làm việc với GitHub. Đó là một khuôn khổ cho GPU tăng tốc học tập sâu được viết bằng Python và Nvidia CUDA. Tôi đã đăng về nó trên Google+ và ngay sau đó, nó đã được đăng trên Hacker News và đã bị lan truyền một vài ngày. Sau đó tôi cũng đã đăng nó một lần nữa trong subreddit Machine Learning và toàn bộ dự án của tôi đã nhặt được 822 sao và 47 dĩa trên GitHub, điều này thực sự rất thú vị. 822 sao có nghĩa là dự án của tôi nằm trong 200 dự án Python hàng đầu trên GitHub và trên thực tế có nhiều sao hơn một số dự án Python cao và được sử dụng rộng rãi như virtualenv.

Mặc dù có sự quan tâm đáng kể cho dự án của tôi, tôi rất thất vọng với sự tham gia thực tế mà tôi đã thấy cho đến nay. Không ai trong số 47 nhánh trong các dự án của tôi từng có bất kỳ cam kết nào, tôi chưa nhận được bất kỳ yêu cầu kéo nào và chỉ có ba vấn đề được gửi bởi hai người. Có vẻ như dự án của tôi có khả năng rất thú vị đối với nhiều người, nhưng họ chỉ đánh dấu sao hoặc rẽ nhánh một lần và sau đó không bao giờ quay lại hoặc sử dụng nó liên tục.

Làm cách nào tôi có thể cải thiện sự tham gia để yêu cầu người dùng gửi lỗi hoặc yêu cầu nâng cao hoặc có người đóng góp gửi thay đổi?


5
Đây là loại dự án mà nhiều người sẽ coi là tuyệt vời, nhưng thực tế sẽ không sử dụng nó.
CodeInChaos

1
Tôi đoán hầu hết mọi người sẽ đánh dấu dự án của bạn dưới dạng dấu trang bởi vì trong khi lướt qua readme.md, họ đã đọc một số từ thông dụng (Python, CUDA) nghe có vẻ hay để chơi ở giai đoạn sau. Tôi là một nhà phát triển phần mềm cao cấp, nhưng ngay cả sau khi xem trang dự án github của bạn trong vài phút, tôi chỉ có một ý tưởng mơ hồ về việc này là gì. Nếu bạn muốn mọi người đóng góp cho dự án của mình, lời khuyên - hoàn toàn không khoa học - của tôi sẽ được trình bày theo cách mà một người không biết nhiều về mạng lưới thần kinh (và tất cả các công cụ chuyên môn khác) cũng có thể hiểu được.
ssc

Câu trả lời:


25

Bạn đã làm việc rất chăm chỉ về điều này. Xin chúc mừng tất cả sự chú ý, nhưng xin lỗi vì nó không hấp dẫn.

Điều đầu tiên tôi nhận thấy là không có vấn đề. Để thu hút mọi người tham gia, bạn phải hiển thị trong nguồn cấp tin tức GitHub của họ. Khi bạn bắt đầu một vấn đề, nó sẽ hiển thị cho những người theo dõi dự án (không phải những người đã đóng vai chính). Vì vậy, quy mô cộng đồng của bạn thực sự là khoảng 80 người theo dõi. Đó chỉ là những người theo dõi mà bạn nên nghĩ về. Người đi bộ chỉ có thể lấy mã và bỏ đi, và các ngôi sao giống như dấu trang. Một người theo dõi sẽ được thông báo về các vấn đề mới.

Hãy thử mở một số vấn đề dễ dàng.

CHỈNH SỬA:

README.md của bạn là quảng cáo của bạn cho repo. Đó là điều đầu tiên mọi người sẽ đọc, và là điều đầu tiên họ chuyển sang giúp đỡ. 2/3 số readme của bạn nói về những gì Hebel nói bằng ngôn ngữ cụ thể về mặt kỹ thuật (nghĩa là tôi không biết bạn đang nói về cái gì). 1/3 dưới chỉ có một vài hướng dẫn cài đặt.

Một trong những điều khó khăn nhất mà tôi tìm thấy với GitHub là khiến các dự án thực sự làm những gì tác giả tuyên bố. Cài đặt, chạy và làm việc chiếm nhiều thời gian nhất. Nếu ai đó nhận được repo của bạn nhưng không thể làm cho nó hoạt động, thì bạn sẽ không bao giờ nhận được yêu cầu kéo.

Tôi chỉ có thể nghi ngờ rằng đây là nguyên nhân.

Sửa lại readme của bạn và đặt hướng dẫn bắt đầu / cài đặt ngay trên đầu. Vì vậy, mọi người có thể nhảy ngay vào và đi.

Thứ hai, bao gồm một số loại mẫu / ví dụ mà họ có thể chạy nhanh mà thể hiện được lợi ích của dự án.


3
Không còn nghi ngờ gì nữa. Nếu bạn có một phần trong README giống như "Đóng góp: sao chép repo, hãy chạy tập lệnh xây dựng một dòng này, thêm một tính năng, thêm một bài kiểm tra, gửi PR" thì tôi nghĩ bạn sẽ thực hiện được nhiều bước tiến. Có hàng tấn quán tính nhảy vào dự án của người khác. Làm cho nó dễ dàng cho họ!
Daniel J. Pritchett
Khi sử dụng trang web của chúng tôi, bạn xác nhận rằng bạn đã đọc và hiểu Chính sách cookieChính sách bảo mật của chúng tôi.
Licensed under cc by-sa 3.0 with attribution required.