nakorndev / hello-world

ฝึกการใช้งาน Pull request กับ GitHub

Hello, world!

https://nakorndev.github.io/hello-world/ Repository สำหรับมือใหม่เพื่อการฝึกฝนใช้งาน Pull requests ผ่าน GitHub

สามารถติดตามคอร์สเรียนฟรีเพิ่มเติมสำหรับโปรแกรมเมอร์ฝึกหัดได้ที่ https://www.facebook.com/nakorncode

วิธีเรียนกับเรา

เพื่อการเรียนที่ดีกว่าเดิม สามารถเริ่มต้นได้ผ่านกลุ่มเรียนรู้ฟรีที่ https://www.facebook.com/groups/nakorncode.free/ โดยเนื้อหาเกี่ยวกับ Git นั้นจะอยู่ส่วนล่างๆของเนื้อหาทั้งหมด

Repository นี้คืออะไร

Repository (โปรเจค) นี้จะเป็นการนำชื่อข้อมูลทุกๆ Contributors (ผู้ร่วมพัฒนา) จากไฟล์ ./data/*.yml ทั้งหมดมาแสดงผล ซึ่งก็จะเป็นเพียงแค่ทดลองนำเข้าข้อมูลโปรไฟล์เล็กน้อยมายัง Repository คนอื่นผ่านการ Pull requests

หากได้รับการ Merge เนื้อหาจะถูกทำงานผ่าน Workflows ของ GitHub Actions เพื่อสร้างหน้าเว็บใหม่พร้อมกับชื่อของคุณ และรูปประจำตัวแบบสุ่มที่พัฒนาโดย DiceBear/avatars

สเปคการแก้ไข

ในการขอให้ Merge ผ่านได้ จะมีเงื่อนไขดังนี้

• ไฟล์ใหม่ต้องตั้งเป็นชื่อ ./data/<your-github-username>.yml เท่านั้น เช่น ./data/nakorndev.yml
• ไม่อนุญาตให้แก้ไขอย่างอื่นนอกจากไฟล์ .yml ที่กำหนด และชื่อไฟล์ต้องถูกต้อง
• เอกสารภายในจะต้องมีการ เว้นบรรทัด ในบรรทัดสุดท้ายให้ถูกต้องด้วย คลิกเพื่อดูรูปตัวอย่าง
• ข้อมูลทั้งหมดจะปลอมเอา หรือจะไม่กรอกบางอย่างก็ได้ สำหรับผู้ที่ต้องการปิดข้อมูลส่วนตัว
• ข้อมูลภายในสามารถคัดลอกตามนี้เพื่อไปใช้งานได้

full_name: <ชื่อจริง ไม่เกิน 40 ตัวอักษร>
nickname: <ชื่อเล่น ไม่เกิน 10 ตัวอักษร>
gender: <เพศ จำเป็นต้องระบุ โดยใช้เฉพาะคำว่า "male" หรือ "female" เท่านั้น>
birth_year: <ระบุปีเกิด ได้ตั้งแต่ 0 จนถึงปีปัจจุบันเป็นตัวเลข หรือเว้นว่างไว้>
message: <ข้อความใดๆก็ได้ แต่ก็ควรมีมารยาทเนอะ>

ดูตัวอย่างเพิ่มเติมได้ที่ไฟล์ ./data/nakorndev.yml

ขั้นตอนแนะนำการเริ่ม Pull request

• เริ่มต้น ให้ทำการกด Fork มุมขวาบนของเว็บ เพื่อคัดลอกทั้ง Repository นี้ไปเป็นของเรา
• ดำเนินการ git clone ไปยังเครื่องของคุณ
• จากนั้นเพิ่มไฟล์ตามชื่อ ./data/<your-github-username>.yml ของคุณที่ถูกต้อง เช่น ./data/myuser123.yml
• คัดลอกรูปแบบข้อมูลจากคนอื่น จากนั้นเปลี่ยนให้เป็นของเราเองตามสเปค หากเกินสเปคจะทำให้ Merge ไม่ผ่านได้
• เสร็จแล้ว git add git commit และ git push ตามลำดับมาที่ Branch ใดๆก็ได้
• กลับมาที่หน้า nakorndev/hello-world ไปที่แท็ก Pull requests
• เลือก New pull request ปุ่มสีเขียว
• ให้เลือก Compare จาก base repository: nakorndev/hello-world base: main ← head repository: <your-github-username>/hello-world compare: <your-branch>
  • หากขั้นตอนนี้ไม่ขึ้นให้เลือก ให้กดปุ่ม compare across forks ที่เป็นลิงก์แบบข้อความ
• จากนั้นให้ระบุข้อมูลที่ต้องการใดๆก็ได้ และดำเนินการต่อ
• รอให้ผู้ดูแล Repository นี้ดำเนินการ Merge หรือบอกให้ปรับปรุงเนื้อหาหากไม่ถูกต้อง