เริ่มต้นสร้าง Pull Request แรกกัน!

ในบทความนี้ เราจะมาเรียนรู้วิธีการสร้าง Pull Request แรกของเราใน GitHub โดยเราจะใช้โปรเจกต์ TT-SS Learning Portal ในการลองสร้าง Pull Request กัน

IMPORTANT

สำหรับน้อง ๆ ฝึกงาน คนไหนที่ไม่สามารถเข้าถึง Repository นี้ได้ ให้น้องแจ้งพี่ ๆ ในห้อง #internship บน Slack ได้เลยนะครับ

1. เข้าไปที่ Repository และไปที่แท็บ Issues จากนั้นลองหา issue ที่เป็นชื่อของคุณดู ซึ่งโดยส่วนใหญ่แล้ว ผมจะติด tag good first issue ไว้ให้แล้ว

   

2. ทำการอ่านรายละเอียด issue ของคุณให้เข้าใจ เมื่อเข้าใจแล้วให้คอมเมนต์ใน issue นี้ เพื่อแจ้งว่าคุณจะทำ issue นี้ จากนั้น Maintainer จะทำการ assign issue นี้ให้คุณ

   

3. ถึงเวลาลุยกันแล้ว.. ก่อนอื่นคุณต้องทำการ clone โปรเจกต์นี้มาก่อน โดยใช้คำสั่ง

   HTTPS

   git clone https://github.com/T-T-Software-Solution/learning-portal.git

   SSH

   git clone git@github.com:T-T-Software-Solution/learning-portal.git

4. หลังจาก clone โปรเจกต์เสร็จแล้ว ให้ทำการติดตั้ง dependencies ของโปรเจกต์นี้ โดยใช้คำสั่ง

   pnpm install

5. ทำการสร้าง branch ใหม่ โดยใช้คำสั่ง

    git checkout -b <branch-name>

6. ทำการแก้ไขโค้ดตาม issue ที่คุณได้รับมอบหมาย และเมื่อแก้ไขเสร็จแล้ว ให้ทำการ commit โค้ดของคุณ โดยใช้คำสั่ง git add และ git commit โดยให้เขียน commit message โดยใช้รูปแบบของ Conventional Commits

   git add .
   git commit -m "docs: <commit-message>"

7. ทำการ push branch ของคุณขึ้นไปยัง GitHub โดยใช้คำสั่ง

   git push origin <branch-name>

8. ทำการสร้าง Pull Request โดยไปที่แท็บ Pull Requests และกดปุ่ม New Pull Request

   

9. กรอกข้อมูลให้ครบถ้วน และกดปุ่ม Create Pull Request

   

10. รอ Maintainer ทำการ review pull request ของคุณ และเมื่อ review เสร็จแล้ว จะมีการทำการ merge pull request ของคุณไปที่ main branch แต่ระหว่างนี้คุณสามารถลองดู preview เว็บไซต์ที่คุณเพิ่งได้แก้ไขไปได้ด้วยนะ ถ้าสมมติว่าดูแล้วไม่ชอบคุณสามารถ commit มาเพิ่มเติมได้เลย

จบแล้ว! 🎉

เยี่ยมมาก! คุณได้สร้าง Pull Request แรกของคุณแล้ว ขอบคุณที่มาร่วมเป็นส่วนหนึ่งของ TT-SS Learning Portal ครับ