หมายเหตุ
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลอง ลงชื่อเข้าใช้หรือเปลี่ยนไดเรกทอรีได้
การเข้าถึงหน้านี้ต้องได้รับการอนุญาต คุณสามารถลองเปลี่ยนไดเรกทอรีได้
Hacktoberfest เป็นงานประจําปีทั่วโลกจัดขึ้นในช่วงเดือนตุลาคม กิจกรรมนี้สนับสนุนให้นักพัฒนาโอเพนซอร์ส (Open Source)มีส่วนร่วมกับที่เก็บผ่านคําขอดึงข้อมูล (PR) GitHub โฮสต์พื้นที่เก็บข้อมูลโอเพนซอร์ส (Open Source)จํานวนมากที่มีส่วนร่วมในเนื้อหา Microsoft Learn พื้นที่เก็บข้อมูลบางส่วนมีส่วนร่วมในเหตุการณ์ Hacktoberfest อย่างแข็งขัน ในบทความนี้ คุณจะได้เรียนรู้วิธีการค้นหาที่เก็บใดกําลังยอมรับ PR และสิ่งที่คุณคาดหวังในฐานะผู้ร่วมให้ข้อมูล
ค้นหาที่เก็บ
เพื่อค้นหาว่าที่เก็บ Microsoft Learn เข้าร่วมใน Hacktoberfest หรือไม่คุณจะเห็น หัวข้อ hacktoberfest ในโครงการ
ในการกรองที่เก็บ Microsoft Learn และ .NET ทั้งหมดที่มีหัวข้อ hacktoberfest ดูหัวข้อ GitHub: Hacktoberfest
หรือที่เก็บอาจเลือกใช้ Hacktoberfest ป้ายชื่อแทน ป้ายชื่อนี้มีความสะดวกสําหรับปัญหาการกรอง สําหรับข้อมูลเพิ่มเติม ดูปัญหาการกรองและคําขอดึงข้อมูลตามป้ายชื่อ
เคล็ดลับ
ถ้าคุณเป็นผู้ดูแลระบบที่เก็บและคุณต้องการอนุญาตให้ repo ของคุณเข้าร่วม Hacktoberfest ให้เพิ่ม hacktoberfest หัวข้อลงใน repo สําหรับข้อมูลเพิ่มเติม ดูการจัดประเภทที่เก็บของคุณด้วยหัวข้อ
มีส่วนร่วม
เพื่อมีส่วนร่วมใน repo โอเพนซอร์ส (Open Source) คุณต้องกําหนดค่าบัญชีของคุณเพื่อมีส่วนร่วมกับ Microsoft Learn ก่อน ถ้าคุณยังไม่เคยทํากระบวนการนี้ให้เสร็จสมบูรณ์ เริ่มต้นโดย การลงทะเบียนสําหรับบัญชี GitHub คุณยังต้องลงทะเบียนโปรไฟล์เพื่อติดตามความพยายามของคุณด้วย ดู Hacktoberfest
เมื่อบัญชีของคุณได้รับการกําหนดค่าแล้ว เริ่มต้นด้วยการอ่านและยึดตาม ไฟล์ CONTRIBUTING.md ที่รากของที่เก็บที่คุณต้องการมีส่วนร่วม ไฟล์เหล่านี้ทําหน้าที่เป็นแนวทางเมื่อร่วมสร้าง ต่อไปนี้คือตัวอย่างคู่มือผู้ร่วมสร้างจากที่เก็บ Microsoft Learn ยอดนิยมบางรายการ:
นอกเหนือจากไฟล์ Markdown ร่วมให้ข้อมูลแล้ว หากที่เก็บมี ไฟล์ CODE_OF_CONDUCT.md ข้อกําหนดจะต้องปฏิบัติตามลักษณะการทํางานที่คาดไว้ในชุมชน และต่อไปนี้คือตัวอย่างทั่วไปบางตัวอย่าง:
สําหรับข้อมูลเพิ่มเติม ดู Hacktoberfest: การเข้าร่วม
เลือกปัญหา
เมื่อต้องการค้นหาปัญหาในการทํางานในที่เก็บที่เข้าร่วม ให้กรองปัญหาสําหรับ up-for-grabs ป้ายชื่อหรือ help-wanted GitHub ในขณะที่คุณสามารถแก้ไขปัญหาอื่น ๆ มันง่ายกว่าที่จะมุ่งเน้นปัญหาที่มีขอบเขตที่กําหนดไว้อย่างดีและมีอยู่ในตัวเอง นอกเหนือจากที่เก็บ Microsoft Learn คุณสามารถใช้ไซต์ต่อไปนี้สําหรับผู้เริ่มต้น:
สําหรับข้อมูลเพิ่มเติมดู Hacktoberfest: ผู้เริ่มต้น
ความคาดหวังที่มีคุณภาพ
หากต้องการให้การสนับสนุนที่ประสบความสําเร็จกับที่เก็บ Microsoft Learn โอเพนซอร์ส (Open Source) ให้สร้าง PR ที่มีความหมายและส่งผลกระทบ ตัวอย่างต่อไปนี้จากเว็บไซต์ Hacktoberfest อย่างเป็นทางการถือว่า เป็นการมีส่วนร่วมที่มีคุณภาพต่ํา:
- PR แบบอัตโนมัติ (ตัวอย่างเช่น PR ที่เปิดสคริปต์เพื่อลบช่องว่าง แก้ไขการพิมพ์ผิด หรือปรับรูปภาพให้เหมาะสม)
- PR ที่ขัดจังหวะ (เช่น การรับสาขาหรือความยอมรับของบุคคลอื่นและการสร้าง PR)
- PR ที่ผู้ดูแลโครงการคํานึงถึงเป็นอุปสรรคต่อการช่วยเหลือ
- การส่งที่พยายามทําได้ง่ายๆ คือ +1 จํานวน PR ของคุณสําหรับเดือนตุลาคม
สุดท้าย PR เพื่อแก้ไขการพิมพ์ผิดสามารถทําได้ แต่ PR ห้ารายการเพื่อลบช่องว่างที่หลงทางไม่ได้
สําหรับข้อมูลเพิ่มเติม ดู Hacktoberfest: ค่า
เปิด PR
PR เป็นวิธีที่สะดวกสําหรับผู้ร่วมโครงการในการเสนอชุดการเปลี่ยนแปลง เมื่อเปิด PR ให้ระบุในความคิดเห็นต้นฉบับซึ่งมีวัตถุประสงค์เพื่อมีส่วนร่วม hacktoberfest PR ที่สําเร็จมีลักษณะทั่วไปเหล่านี้:
- PR จะเพิ่มค่า
- ผู้สนับสนุนเปิดรับคําติชม
- การเปลี่ยนแปลงที่ตั้งใจไว้นั้นมีการปราบปรามอย่างดี
- การเปลี่ยนแปลงจะเกี่ยวข้องกับประเด็นที่มีอยู่
หากคุณกําลังเสนอ PR โดยไม่มีปัญหาที่สอดคล้องกัน ให้สร้างปัญหาก่อน สําหรับข้อมูลเพิ่มเติม ดู GitHub: เกี่ยวกับคําขอดึงข้อมูล