ฉันจะดึงดูดผู้ใช้ที่ติดดาวโครงการของฉันบน GitHub ได้อย่างไร


19

ฉันเพิ่งวางโครงการเรียกว่าHebelซึ่งฉันทำงานให้กับ GitHub มันเป็นกรอบสำหรับ GPU ที่เร่งการเรียนรู้อย่างลึกซึ้งที่เขียนใน Python และ Nvidia CUDA ฉันโพสต์เกี่ยวกับเรื่องนี้ใน Google+ และหลังจากนั้นไม่นานมันก็ถูกหยิบขึ้นมาในHacker Newsและมีไวรัสเล็กน้อยในสองสามวัน ภายหลังฉันโพสต์เกี่ยวกับเรื่องนี้อีกครั้งในsubreddit การเรียนรู้ของเครื่องจักรเช่นกันและโครงการของฉันก็หยิบขึ้นมา 822 ดาวและ 47 ส้อมบน GitHub ซึ่งมันทำให้ดีอกดีใจจริงๆ 822 ดาวหมายความว่าโครงการของฉันอยู่ใน 200 อันดับแรกของโครงการ Python บน GitHub และในความเป็นจริงแล้วมีดาวมากกว่าโปรไฟล์สูงบางโครงการที่ใช้กันอย่างแพร่หลายเช่น Python virtualenv

แม้จะมีความสนใจเป็นอย่างมากสำหรับโครงการของฉัน แต่ฉันก็ผิดหวังกับการมีส่วนร่วมจริงที่ฉันได้เห็น ไม่มีส้อมจาก 47 โครงการของฉันที่เคยทำมาฉันไม่ได้รับการร้องขอใด ๆ และมีคนสองคนส่งปัญหาเพียงสามเรื่องเท่านั้น ดูเหมือนว่าโครงการของฉันอาจจะน่าสนใจสำหรับคนจำนวนมาก แต่พวกเขาเพียงติดดาวหรือแยกมันครั้งเดียวแล้วไม่กลับไปใช้มันอีกหรือใช้มันอย่างต่อเนื่อง

ฉันจะปรับปรุงการมีส่วนร่วมเพื่อให้ผู้ใช้ส่งข้อผิดพลาดหรือร้องขอการปรับปรุงหรือให้ผู้สนับสนุนส่งการเปลี่ยนแปลงได้อย่างไร


5
มันเป็นโครงการที่หลายคนคิดว่าเจ๋ง แต่จะไม่ใช้มันด้วยตัวเอง
CodesInChaos

1
ฉันเดาว่าคนส่วนใหญ่ให้ดาวโครงการของคุณเป็นบุ๊กมาร์กเพราะในขณะที่อ่าน readme.md พวกเขาอ่าน buzzwords (Python, CUDA) ที่ให้เสียงที่ยอดเยี่ยมในการเล่นด้วยในภายหลัง ฉันเป็นผู้พัฒนาซอฟต์แวร์ระดับสูง แต่ถึงแม้หลังจากดูหน้าโครงการ GitHub ของคุณสักสองสามนาทีฉันก็มีความคิดที่คลุมเครือว่าเรื่องนี้เกี่ยวข้องกับอะไร หากคุณต้องการให้ผู้คนมีส่วนร่วมในโครงการของคุณคำแนะนำของฉันที่ไม่มีหลักวิทยาศาสตร์จะนำเสนอในรูปแบบที่คนที่ไม่รู้จักเครือข่ายประสาท (และสิ่งอื่น ๆ ที่เชี่ยวชาญ) ก็สามารถเข้าใจได้เช่นกัน
ssc

คำตอบ:


25

คุณทำงานหนักมากในเรื่องนี้ ขอแสดงความยินดีกับความสนใจทั้งหมด แต่ขออภัยที่มันไม่ได้มีส่วนร่วม

สิ่งแรกที่ฉันสังเกตเห็นคือไม่มีปัญหา ในการทำให้ผู้คนมีส่วนร่วมคุณจะต้องปรากฏตัวในฟีดข่าว GitHub ของพวกเขา เมื่อคุณเริ่มปัญหามันจะปรากฏขึ้นสำหรับคนที่ติดตามโครงการ (ไม่ใช่คนที่ติดดาว) ขนาดชุมชนคุณจริงแล้วมีผู้ติดตามประมาณ 80 คน เป็นเพียงผู้ติดตามที่คุณควรคิดถึง ตัวจัดการสามารถหยิบโค้ดและเดินออกไปได้และดาวก็เป็นเหมือนบุ๊คมาร์ค ผู้ติดตามจะได้รับแจ้งถึงปัญหาใหม่

ลองเปิดปัญหาง่าย ๆ

แก้ไข:

README.md ของคุณคือโฆษณาของคุณสำหรับ repo มันเป็นสิ่งแรกที่ผู้คนจะอ่านและสิ่งแรกที่พวกเขาหันไปขอความช่วยเหลือ 2/3 ของ readme ของคุณพูดถึงสิ่งที่ Hebel เป็นในภาษาเฉพาะทางเทคนิค (เช่นฉันไม่รู้ว่าคุณกำลังพูดถึงเรื่องอะไร) 1/3 ที่ต่ำกว่ามีคำแนะนำในการติดตั้งเพียงเล็กน้อย

หนึ่งในสิ่งที่ยากที่สุดที่ฉันได้พบกับ GitHub คือการให้โครงการทำตามที่ผู้เขียนอ้าง การติดตั้งใช้งานและใช้งานต้องใช้เวลาส่วนใหญ่ หากมีคนรับ repo ของคุณ แต่ไม่สามารถใช้งานได้คุณจะไม่ได้รับคำขอดึง

ฉันสามารถสงสัยได้ว่านี่เป็นสาเหตุ

แก้ไข readme ของคุณและวางคำแนะนำในการเริ่ม / ติดตั้งไว้ที่ด้านบน เพื่อให้ผู้คนสามารถกระโดดเข้าและออกได้

ประการที่สองรวมตัวอย่าง / ตัวอย่างบางประเภทที่สามารถทำงานได้อย่างรวดเร็วเพื่อสาธิตประโยชน์ของโครงการ


3
ไม่ต้องสงสัยเลย หากคุณมีส่วนใน README ที่ดูเหมือนว่า "การมีส่วนร่วม: ลอกแบบ repo ให้รันสคริปต์สร้างหนึ่งบรรทัดนี้เพิ่มคุณสมบัติเพิ่มการทดสอบส่งการประชาสัมพันธ์" จากนั้นฉันคิดว่าคุณจะทำอะไรได้มากมาย มีแรงเฉื่อยมากมายในโครงการของคนอื่น ทำให้ง่ายสำหรับพวกเขา!
Daniel J. Pritchett
โดยการใช้ไซต์ของเรา หมายความว่าคุณได้อ่านและทำความเข้าใจนโยบายคุกกี้และนโยบายความเป็นส่วนตัวของเราแล้ว
Licensed under cc by-sa 3.0 with attribution required.