ครั้งแรกของทุกอย่างมันมักจะยากเสมอ โดยเฉพาะการทำงานร่วมกับผู้อื่น เวลาทำอะไรผิดพลาดก็จะรู้สึกไม่สบายใจ แต่ opensource คือโลกของการทำงานร่วมกัน! เราจึงอยากให้ผู้ที่เข้ามาใหม่ได้เรียนรู้วิธีการ "คอนทริบิ้วต์" ผลงานร่วมกับผู้อื่นในกิตฮับแบบง่ายๆ
การอ่านบทความและทำตามทัวเทอเรียลต่างๆก็ช่วยได้ แต่อะไรจะดีไปกว่า การลงมือทำสิ่งนั้นๆด้วยตัวเองล่ะ! โปรเจ็คนี้จะสอนให้มือใหม่ส่ง "คอนทริบิ้วชั่นครั้งแรก" ได้อย่างง่ายๆ
จำเอาไว้ว่า: ทำใจให้สบาย ยิ่งคุณผ่อนคลายมากเท่าไหร่ คุณก็ยิ่งเรียนรู้ได้ดีมากขึ้นเท่านั้น!
ถ้าคุณอยากร่วมส่งคอนทริบิ้วชั่นครั้งแรกของคุณ เพียงแค่ทำตามขั้นตอนง่ายๆด้านล่าง เราบอกเลยว่า มันจะสนุกแน่นอน
อ่านบทความนี้ในภาษาอื่นๆ: Indonesian, French, Spanish, Dutch, Hindi, Russian, Japanese, Vietnamese, Polish, Korean, German, Simplified Chinese, Traditional Chinese, Greek, العربية, Ukrainian, Português/Brasil, Italian และ ภาษาไทย.
ถ้ายังไม่ได้ลง git ติดตั้ง git ได้ที่นี่ .
โปรเจ็คหลักนี้ จะเรียกว่า โปรเจ็คต้นน้ำ คุณสามารถแยกโปรเจ็คต้นน้ำออกไปทำที่แอคเคาน์ส่วนตัวของคุณได้ โดยการกดปุ่ม "Fork" ที่ด้านบนของหน้านี้
แล้วโปรเจ็คต้นน้ำจะถูกคัดลอกนำไปใส่ไว้ในแอคเคาน์ของคุณ
เอาล่ะ ตอนนี้ก็ Clone โปรเจ็คนี้ลงบนเครื่องคอมพิวเตอร์ของคุณ โดยการคลิ๊กที่ปุ่ม "Clone" แล้วเลือก copy to clipboard (คำสั่งคัดลอก)
เปิดโปรแกรมเทอร์มินอลในเครื่อง (เช่น Terminal ใน MacOS หรือ cmd ใน Windows) แล้วรันคำสั่ง git ต่อไปนี้:
git clone "url นี่คัดลอกไว้"
"url ที่คัดลอกไว้" (ไม่ต้องใส่ " ") คือ url ของโปรเจ็คของคุณ คุณสามารถเลื่อนกลับไปดูวิธีคัดลอก url ได้จากหัวข้อก่อนหน้านี้
ตัวอย่าง:
git clone https://github.com/this-is-you/first-contributions.git
this-is-you คือชื่อ username ของคุณบน GitHub ถึงตรงนี้คุณได้ "Clone" โปรเจ็ค first-contributions ไปไว้ที่คอมพิวเตอร์ของคุณแล้ว
ในโปรแกรมเทอร์มินอล เปลี่ยน directory ไปยังที่ที่คุณได้ Clone โปรเจ็คไว้:
cd first-contributions
ตรงนี้ให้สร้าง branch (แตกกิ่งการทำงานใหม่) ด้วยคำสั่ง git checkout:
git checkout -b <ชื่อ branch>
ตัวอย่าง:
git checkout -b add-alonzo-church
(ปกติชื่อของ branch ไม่จำเป็นต้องมีคำว่า add แต่ในโปรเจ็คนี้อยากให้ใช้ add-ชื่อ-ของ-คุณ เพราะชื่อของคุณจะไปแสดงอยู่ในรายชื่อ Contributors (ผู้เข้าร่วม) ของโปรเจ็คนี้
ตอนนี้ให้เปิดไฟล์ Contributors.md ในโปรแกรม text editor เพิ่มชื่อของคุณลงไป จากนั้นเซฟไฟล์
ในโปรแกรมเทอร์มินอล ถ้าคุณอยู่ที่ directory ของโปรเจ็ค ให้ลองพิมพ์คำสั่ง git status จะเห็นว่าคุณได้ทำการเปลี่ยนอะไรไปบ้าง
เพิ่มการเปลี่ยนแปลงนั้นๆเข้าไปใน branch ที่เพิ่งสร้าง ด้วยคำสั่ง git add:
git add Contributors.md
ตอนนี้ "Commit" การเปลี่ยนแปลงนั้นๆ ด้วยคำสั่ง git commit:
git commit -m "Add <ชื่อของคุณ> to Contributors list"
แทนที่ <ชื่อของคุณ> ด้วยชื่อจริงๆของคุณ.
"Push" ผลงานที่คุณทำเมื่อกี้นี้ขึ้นกิตฮับ ด้วยคำสั่ง git push:
git push origin <ชื่อ branch ของคุณ>
แทนที่ <ชื่อ branch ของคุณ> ด้วยชื่อของ branch ของคุณที่เพิ่งสร้างไปเมื่อหัวข้อที่แล้วๆ (add-ชื่อ-ของ-คุณ)
ไปที่ repository ของคุณบนกิตฮับ คลิ๊กที่ Compare & pull request
ตอนนี้ก็ส่ง Pull Request ไปที่โปรเจ็คต้นน้ำได้เลย
แล้วเดี๋ยวเราจะ "Merge" หรือรวมผลงานที่คุณได้เปลี่ยนแปลงโค้ดมาที่ master branch ของโปรเจ็คนี้ คุณจะได้รับอีเมลล์ เมื่อเราได้ทำการ Merge ผลงานของคุณเรียบร้อยแล้ว
 |
 |
 |
|---|---|---|
| GitHub Desktop | Visual Studio 2017 | GitKraken |
คุณจะลองมาเข้าร่วมทีมของเราใน Slack ก็ได้นะ! ถ้าคุณมีข้อสงสัยอะไรเพิ่มเติม สามารถเข้ามาถามได้เลย เข้าร่วม
ข้างล่างนี่คือ repo สำหรับมือใหม่ ที่จะช่วยให้คุณใช้งาน Tools ต่างๆสำหรับโค้ดดิ้งได้ง่ายขึ้น ลองเข้าไปดูกันนะ :)
