/hello-world

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

Primary LanguageHTMLMIT LicenseMIT

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 หรือบอกให้ปรับปรุงเนื้อหาหากไม่ถูกต้อง