ภาพรวมของการแก้ไขเอกสารบน Microsoft Learn
ขอขอบคุณสําหรับความสนใจในการแก้ไขเอกสารบน Microsoft Learn! การร่วมสร้างของคุณช่วยให้เรามั่นใจว่าเอกสารประกอบของเราได้รับการเขียนอย่างดี ทันสมัย และถูกต้อง ข้อมูลในหน้านี้จะช่วยให้คุณตัดสินใจว่า วิธีการร่วมสร้างที่เหมาะสมกับคุณที่สุด
ข้อกำหนดเบื้องต้น
ก่อนที่คุณจะเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณได้ลงชื่อเข้าใช้บัญชี GitHub ของคุณ ถ้าคุณยังไม่มีบัญชี GitHub ให้ไปที่ https://github.com/join ขั้นตอนการลงทะเบียนที่รวดเร็วและฟรี
การเปลี่ยนแปลงเล็กน้อยในเอกสาร
การเปลี่ยนแปลงเล็กน้อยทําได้ง่ายและรวดเร็ว ตัวอย่างของการเปลี่ยนแปลงเล็กน้อยได้แก่:
- การแก้ไขการพิมพ์ผิด
- การแก้ไขบทความเดียว
- การเพิ่มส่วนไปยังบทความ
- การแก้ไขข้อผิดพลาด
- การอัปเดตลิงก์ที่ใช้งานไม่ได้
ถ้าคุณกําลังทําการเปลี่ยนแปลงเพียงเล็กน้อย สิ่งที่คุณต้องมีคือบัญชี GitHub!
เมื่อต้องการเปลี่ยนแปลงเล็กน้อย ให้เลือกไอคอน ดินสอ แก้ไขเอกสาร นี้ ที่ด้านบนของบทความ การดําเนินการนี้จะนําคุณไปยังไฟล์ต้นฉบับใน GitHub ซึ่งคุณสามารถทําการเปลี่ยนแปลงของคุณได้ เมื่อคุณทําเสร็จแล้ว คุณจะได้รับพร้อมท์ให้สร้างคําขอดึงข้อมูล (PR) เพื่อเสนอการเปลี่ยนแปลงของคุณ สําหรับการฝึกปฏิบัติทั้งหมดของกระบวนการนี้ ดูแก้ไขเอกสารประกอบในเบราว์เซอร์
การเปลี่ยนแปลงหลักในเอกสาร
การเปลี่ยนแปลงที่สําคัญเกี่ยวข้องกับเวลาและความพยายามมากขึ้น ตัวอย่างของการเปลี่ยนแปลงหลักได้แก่:
- การเปลี่ยนแปลงที่ซับซ้อนที่จะนําคุณใช้เวลาหลายวันในการดําเนินการให้เสร็จสมบูรณ์
- การแก้ไขบทความหลายบทความที่คุณต้องการส่งร่วมกัน
- การสร้างบทความใหม่
- การสนับสนุนมักจะ
ถ้าคุณกําลังทําการเปลี่ยนแปลงที่สําคัญ คุณจําเป็นต้องดาวน์โหลดและติดตั้งเครื่องมือบางอย่างเพื่อทําให้งานของคุณง่ายขึ้น ทําตามขั้นตอนเหล่านี้เพื่อเริ่มต้นใช้งาน:
- ติดตั้งเครื่องมือ Git และ Markdown
- ตั้งค่าที่เก็บ Git ภายในเครื่อง
- ทําการเปลี่ยนแปลงในเอกสาร
- สร้าง PR
ภาพรวมของกระบวนการ
โฟลว์กระบวนการด้านล่างแสดงขั้นตอนระดับสูงที่เกี่ยวข้องในการเริ่มต้นใช้งานสําหรับการเปลี่ยนแปลงเล็กน้อยและที่สําคัญ โปรดสังเกตว่าบางรายการเป็นขั้นตอนแบบครั้งเดียว ในขณะที่ขั้นตอนอื่น ๆ เกิดขึ้นทุกครั้งที่คุณเริ่มการสนับสนุนใหม่
รูปภาพเริ่มต้นด้วยจุดตัดสินใจของสิ่งนี้คือการสนับสนุนครั้งแรกของคุณหรือไม่ ถ้าใช่ ขั้นตอนต่อไปคือการตั้งค่าบัญชี GitHub ของคุณ ถ้าไม่ใช่ ขั้นตอนถัดไปคือจุดตัดสินใจอีกจุดหนึ่งของการเปลี่ยนแปลงของคุณเป็นผู้เยาว์หรือไม่ ถ้าใช่ ขั้นตอนถัดไปคือแก้ไขภายในเบราว์เซอร์ ถ้าไม่มี ขั้นตอนถัดไปเกี่ยวข้องกับการติดตั้งเครื่องมือการเขียน การสําเนาและการลอกแบบ repo ทําการเปลี่ยนแปลง การเปิดคําขอดึงข้อมูล และตรวจสอบและลงชื่อออกในคําขอดึงข้อมูลของคุณ
การเปลี่ยนแปลงโมดูลการฝึกอบรม
ผู้สนับสนุนไม่สามารถแก้ไขหรือเสนอการเปลี่ยนแปลงโมดูลการฝึกอบรมได้ ในขณะนี้ เฉพาะเอกสาร Microsoft Learn ที่จัดเก็บไว้ในที่เก็บสาธารณะเท่านั้นที่จะเปิดสําหรับการร่วมให้ข้อมูลสาธารณะ