ภาพรวมของการแก้ไขเอกสารบน Microsoft Learn

ขอขอบคุณสําหรับความสนใจในการแก้ไขเอกสารบน Microsoft Learn! การร่วมสร้างของคุณช่วยให้เรามั่นใจว่าเอกสารประกอบของเราได้รับการเขียนอย่างดี ทันสมัย และถูกต้อง ข้อมูลในหน้านี้จะช่วยให้คุณตัดสินใจว่า วิธีการร่วมสร้างที่เหมาะสมกับคุณที่สุด

ข้อกำหนดเบื้องต้น

ก่อนที่คุณจะเริ่มต้นใช้งาน ตรวจสอบให้แน่ใจว่าคุณได้ลงชื่อเข้าใช้บัญชี GitHub ของคุณแล้ว ถ้าคุณยังไม่มีบัญชี GitHub ให้ไปที่ https://github.com/join ขั้นตอนการลงทะเบียนที่รวดเร็วและฟรี

การเปลี่ยนแปลงเล็กน้อยในเอกสาร

การเปลี่ยนแปลงเล็กน้อยทําได้ง่ายและรวดเร็ว ตัวอย่างของการเปลี่ยนแปลงเล็กน้อยได้แก่:

  • การแก้ไขการพิมพ์ผิด
  • การแก้ไขบทความเดียว
  • การเพิ่มส่วนไปยังบทความ
  • การแก้ไขข้อผิดพลาด
  • การอัปเดตลิงก์ที่ใช้งานไม่ได้

ถ้าคุณกําลังทําการเปลี่ยนแปลงเพียงเล็กน้อย สิ่งที่คุณต้องมีคือบัญชี GitHub!

เมื่อต้องการเปลี่ยนแปลงเล็กน้อย ให้เลือกไอคอน ดินสอ แก้ไขเอกสาร นี้ ที่ด้านบนของบทความ การดําเนินการนี้จะนําคุณไปยังไฟล์ต้นฉบับใน GitHub ซึ่งคุณสามารถทําการเปลี่ยนแปลงของคุณได้ เมื่อคุณทําเสร็จแล้ว คุณจะได้รับพร้อมท์ให้สร้างคําขอดึงข้อมูล (PR) เพื่อเสนอการเปลี่ยนแปลงของคุณ สําหรับการฝึกปฏิบัติทั้งหมดของกระบวนการนี้ ดูแก้ไขเอกสารประกอบในเบราว์เซอร์

การเปลี่ยนแปลงหลักในเอกสาร

การเปลี่ยนแปลงที่สําคัญเกี่ยวข้องกับเวลาและความพยายามมากขึ้น ตัวอย่างของการเปลี่ยนแปลงหลักได้แก่:

  • การเปลี่ยนแปลงที่ซับซ้อนที่จะนําคุณใช้เวลาหลายวันในการดําเนินการให้เสร็จสมบูรณ์
  • การแก้ไขบทความหลายบทความที่คุณต้องการส่งร่วมกัน
  • การสร้างบทความใหม่
  • การสนับสนุนมักจะ

ถ้าคุณกําลังทําการเปลี่ยนแปลงที่สําคัญ คุณจําเป็นต้องดาวน์โหลดและติดตั้งเครื่องมือบางอย่างเพื่อทําให้งานของคุณง่ายขึ้น ทําตามขั้นตอนเหล่านี้เพื่อเริ่มต้นใช้งาน:

  1. ติดตั้งเครื่องมือ Git และ Markdown
  2. ตั้งค่าที่เก็บ Git ภายในเครื่อง
  3. ทําการเปลี่ยนแปลงในเอกสาร
  4. สร้าง PR

ภาพรวมของกระบวนการ

โฟลว์กระบวนการด้านล่างแสดงขั้นตอนระดับสูงที่เกี่ยวข้องในการเริ่มต้นใช้งานสําหรับการเปลี่ยนแปลงเล็กน้อยและที่สําคัญ โปรดสังเกตว่าบางรายการเป็นขั้นตอนแบบครั้งเดียว ในขณะที่ขั้นตอนอื่น ๆ เกิดขึ้นทุกครั้งที่คุณเริ่มการสนับสนุนใหม่

Process flow map showing the basic workflow for getting started with the contribution process.

รูปภาพเริ่มต้นด้วยจุดตัดสินใจของสิ่งนี้คือการสนับสนุนครั้งแรกของคุณหรือไม่ ถ้าใช่ ขั้นตอนต่อไปคือการตั้งค่าบัญชี GitHub ของคุณ ถ้าไม่ใช่ ขั้นตอนถัดไปคือจุดตัดสินใจอีกจุดหนึ่งของการเปลี่ยนแปลงของคุณเป็นผู้เยาว์หรือไม่ ถ้าใช่ ขั้นตอนถัดไปคือแก้ไขภายในเบราว์เซอร์ ถ้าไม่มี ขั้นตอนถัดไปเกี่ยวข้องกับการติดตั้งเครื่องมือการเขียน การสําเนาและการลอกแบบ repo ทําการเปลี่ยนแปลง การเปิดคําขอดึงข้อมูล และตรวจสอบและลงชื่อออกในคําขอดึงข้อมูลของคุณ

การเปลี่ยนแปลงโมดูลการฝึกอบรม

ผู้สนับสนุนไม่สามารถแก้ไขหรือเสนอการเปลี่ยนแปลงโมดูลการฝึกอบรมได้ ในขณะนี้ เฉพาะเอกสาร Microsoft Learn ที่จัดเก็บไว้ในที่เก็บสาธารณะเท่านั้นที่จะเปิดสําหรับการร่วมให้ข้อมูลสาธารณะ