แชร์ผ่าน


สร้างปัญหา GitHub สําหรับผลิตภัณฑ์โอเพนซอร์ส

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

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

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

หมายเหตุ

เฉพาะผลิตภัณฑ์โอเพนซอร์สที่ใช้ประสบการณ์คําติชมแบบโอเพนซอร์สเท่านั้นที่ยอมรับปัญหา GitHub สําหรับข้อมูลเพิ่มเติมและรายการของที่เก็บที่เข้าร่วม ดู ใช้ประสบการณ์การใช้งานแบบโอเพนซอร์ส หากต้องการเรียนรู้เกี่ยวกับวิธีการให้คําติชมที่ไม่ใช่ GitHub ทั่วทั้งแพลตฟอร์ม Microsoft Learn โปรดดูให้คําติชมเกี่ยวกับ Microsoft Learn

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

สร้างประเด็น

  1. นําทางไปยังบทความที่คุณต้องการแสดงข้อคิดเห็น

  2. เลื่อนไปที่ด้านล่างของบทความที่คุณจะเห็นตัวเลือกสําหรับการส่งคําติชม เลือก เปิดปัญหา เอกสารเพื่อสร้างปัญหาใหม่ คําติชมนี้จะเจาะจงกับเนื้อหาและได้รับการติดตามว่าเป็นปัญหาใน GitHub

    ภาพหน้าจอของด้านล่างของบทความ ที่แสดงตัวเลือกคําติชม

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

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

    สกรีนช็อตของฟอร์มปัญหาใหม่ใน GitHub

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

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

ข้อคิดเห็นเกี่ยวกับปัญหา

คุณสามารถให้ข้อคิดเห็นเกี่ยวกับปัญหาใด ๆ ในที่เก็บที่สนับสนุนปัญหา GitHub ได้ คุณยังสามารถเพิ่มข้อคิดเห็นของคุณเองในประเด็นที่คุณสร้างขึ้นได้

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

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

  2. อ่านปัญหาและข้อคิดเห็นใดๆ ที่ผู้อื่นเพิ่มเข้ามาแล้ว หากคุณต้องการเพิ่มข้อคิดเห็น ให้เลื่อนไปที่ด้านล่างของปัญหา และป้อนข้อคิดเห็นของคุณในกล่องออกจากข้อคิดเห็น เมื่อคุณทําเสร็จแล้ว ให้เลือก ข้อคิดเห็น

    สกรีนช็อตของปัญหา GitHub ที่มีกล่องข้อคิดเห็นที่ด้านล่าง

เปิดคําขอดึงข้อมูลเพื่อแก้ไขปัญหา

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

เมื่อคุณเปิด PR เพื่อจัดการปัญหาแล้ว ให้กลับไปที่ปัญหาและเพิ่มข้อคิดเห็นที่เชื่อมโยงไปยัง PR ของคุณ การดําเนินการนี้ช่วยให้เราติดตามปัญหาและ PR ร่วมกัน ใช้เครื่องหมายปอนด์ (#) ตามด้วยหมายเลข PR เพื่อเชื่อมโยงไปยัง PR ตัวอย่างเช่น หากหมายเลข PR ของคุณคือ 4210 คุณจะต้องป้อน #4210 ความคิดเห็นของคุณ

สกรีนช็อตของกล่องข้อคิดเห็นของปัญหา GitHub ที่มีลิงก์ไปยัง PR