วิธีการรายงานข้อบกพร่อง

This page is a translated version of the page How to report a bug and the translation is 100% complete.


Phabricator is for software bug reports, feature requests, and planning work.
  • To ask technical questions about Wikimedia projects, see m:Tech
  • To ask technical questions about MediaWiki in non-WMF installations, see Project:Support desk

แนวทางนี้จะอธิบายถึงวิธีการเขียนรายงานข้อผิดพลาดที่ดีหรือการร้องขอคุณสมบัติในเครื่องมือติดตามบั๊กของวิกิมีเดีย (ดู ฟาบริเคเตอร์ สำหรับข้อมูลเพิ่มเติม) ซึ่งการรายงานข้อผิดพลาดที่มีประสิทธิภาพมีแนวโน้มที่จะได้รับการแก้ไขอย่างรวดเร็ว การรายงานข้อผิดพลาดจะต้องทำในภาษาอังกฤษ หากคุณไม่สามารถเขียนเป็นภาษาอังกฤษ ให้ลองใช้เครื่องมือแปลภาษา เช่น กูเกิลแปลภาษา

คำแนะนำแบบรวบรัด

  • มีความแม่นยำ
  • มีความกระจ่าง อธิบายว่า (1) อธิบายการเกิดเหตุการณ์นี้ได้หรือไม่ ทีละขั้นตอน ไม่ควรมีช่องว่างให้ตีความเอง (2) สิ่งที่คาดหวังว่าจะได้รับเมื่อทำเช่นนั้น (3) สิ่งที่เกิดขึ้นแทนที่คาดหวังไว้ โดยแต่ละส่วนแยกกันเพื่อให้อ่านง่ายขึ้น
  • ในหนึ่งทาสก์ต้องมีเพียงปัญหาเดียวเท่านั้น
  • ให้ลิงก์ที่เกี่ยวข้องและตัวอย่างเสมอ

ก่อนที่คุณจะทำอะไร

คุณสามารถแจ้งปัญหาซ้ำได้หรือไม่?

ลองพยายามสร้างข้อผิดพลาดขึ้นอีกครั้งในรุ่นล่าสุดของซอร์ฟแวร์ เพื่อดูว่าได้รับการแก้ไขไปแล้วหรือยัง หากเกิดข้อผิดพลาดบนวิกิอย่างวิกิพีเดีย ลองทดสอบกับรุ่นล่าสุดของซอร์ฟแวร์ได้ที่ test2.wikipedia.org

มีผู้อื่นรายงานปัญหาแล้วหรือไม่?

ใช้กล่องค้นหาของเครื่องมือติดตามข้อผิดพลาดวิกิมีเดียเพื่อดูว่าข้อผิดพลาดหรือคุณลักษณะใหม่ที่คุณพบหรือต้องการมีผู้รายงานแล้วหรือไม่ คุณสามารถทำการค้นหาแบบขั้นสูงได้เช่นกันที่หน้าค้นหาขั้นสูง

หากคุณไม่แน่ใจว่ามีการรายงานข้อผิดพลาดที่พบอยู่แล้วหรือไม่ คุณยังคงควรจะรายงานข้อบกพร่องนั้น เป็นการดีกว่าที่จะมีรายงานข้อผิดพลาดซ้ำกันแทนที่จะมีข้อผิดพลาดที่ยังไม่ได้รายงาน

อาจเป็นปัญหาเกี่ยวกับแกดเจตหรือสคริปต์ผูัใช้หรือไม่?

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

รายงานข้อผิดพลาดหรือขอคุณลักษณะใหม่

หากคุณพบกับข้อผิดพลาดในรุ่นมีเดียวิกิในอดีต และดูเหมือนจะยังไม่มีใครมีการรายงาน กรุณา:

  1. ไปที่ phabricator.wikimedia.org
  2. คุณจะถูกขอให้เข้าสู่ระบบ (หรือลงทะเบียน) หากยังมีไม่ได้เข้าสู่ระบบ (ดู "สร้างบัญชีของคุณ ")
  3. กดที่ปุ่มบุ๊คมาร์คบริเวณมุมขวาบนและเลือก "Create Task" (หรือ "Report Security issues" สำหรับการรายงานเกี่ยวกับปัญหาด้านความปลอดภัย )
  4. ให้ข้อมูลต่อไปนี้เป็นอย่างน้อย:
    • ชื่อ: สรุปสั้น ๆ หนึ่งประโยคที่อธิบายถึงปัญหาที่เกิดขึ้น (ไม่ใช่อธิบายวิธีการแก้ปัญหาของคุณ)
      • ตัวอย่างที่ดี: "Selecting gender is not functional on Special:Preferences"
      • ตัวอย่างที่แย่: "Software crashes"
    • คำอธิบาย: รายละเอียดแบบเต็มของปัญหา ให้สารสนเทศที่ละเอียดมากที่สุดเท่าที่เป็นไปได้ทั้งหมดที่คุณมี หากไม่เพียงพอ คุณจะถูกถามข้อมูลเพิ่มเติมพร้อมกับคำแนะนำเกี่ยวกับวิธีการขอรับข้อมูลดังกล่าว ซึ่งควรประกอบไปด้วย:
      • สำหรับข้อผิดพลาด:
        • ขั้นตอนในการแสดงข้อผิดพลาดซ้ำ ขั้นตอนที่สามารถปฏิบัติตามได้ซึ่งทำให้เกิดปัญหาที่ระบุ รวมถึงขั้นตอนพิเศษใด ๆ
          ตัวอย่าง:
          1. Go to https://en.wikipedia.org with Internet Explorer version 10.0;
          2. Make sure you are logged in;
          3. Select "My Preferences" menu;
          4. Go to "Gender" and select female gender from box list;
          5. Click "Save" button.
        • ผลลัพธ์จริง: สิ่งที่ได้รับหลังทำตามขั้นตอนดังกล่าว
          ตัวอย่าง:
          "There is no female gender in front of my username."
        • ผลที่คาดหวัง: สิ่งที่แอพลิเคชันควรจะทำหากไม่มีข้อบกพร่อง
          ตัวอย่าง:
          "My gender is shown in front of my username."
      • สำหรับการขอคุณลักษณะ:
        • รายละเอียดของสิ่งที่คุณต้องการพร้อมเหตุผล ขยายความว่าคุณหวังอะไรจาการได้รับคุณลักษณะ (ปัญหาพื้นฐานจริง ๆ) พร้อมกับระบุตัวอย่าง แต่่่่่กรุณาอย่าให้วิธีการแก้ปัญหา เนื่องจากอาจมีการแก้ปัญหาแบบอื่นที่ดีกว่าที่คุณเสนอและเราจะจมกับการแก้ปัญหาของคุณ User story เป็นวิธีที่ชาญฉลาดที่จะดูสิ่งนี้
          ตัวอย่าง:
          "As a new editor, I would like to be acknowledged for my contribution to the project, so that I feel welcomed and valued"
      • โปรดให้ข้อมูลอื่น ๆ ที่อาจจะมีประโยชน์ เช่น:
        • เว็บเบราเซอร์ สกิน หรือระบบคอมพิวเตอร์ที่คุณพบข้อผิดพลาด
        • ลิงก์หรือความแตกต่างตั้งแต่หนึ่งหน้าหรือมากกว่าที่คุณพบข้อผิดพลาด หรือ
        • หรือว่าปัญหาจะเกิดอยู่ตลอด? แค่บางครั้ง? เฉพาะบางหน้า? หรือเกิดแต่ในสถานการณ์เฉพาะ?
    • การแนบไฟล์ log หรือภาพหน้าจอ (ตรวจสอบว่าไม่มีข้อมูลที่เป็นความลับ) คลิกที่ปุ่ม Upload File (เมฆที่มีลูกศร) ในแถบเครื่องมือบริเวณช่อง Description
    • เลือกแท็ก (หรือคือโครงการ) ในที่ที่คุณได้พบข้อผิดพลาด:
      • โครงการจะช่วยให้ผู้พัฒนาหาทาสก์ที่เกี่ยวข้องกับตนได้ง่ายขึ้น เพื่อแจ้งโครงการที่เหมาะสม ใช้ฟังก์ชันการค้นหา (ด้านบนขวา) เพื่อหาคำอธิบานของแท็กที่อาจเกี่ยวข้อง
      • เช่นโครงการ MediaWiki-General-or-Unknown สำหรับซอฟต์แวร์วิกิของตัวมันเอง หรือ Wikimedia-Site-Requests สำหรับการเปลี่ยนการกำหนดค่าในเว็บไซต์วิกิมีเดีย (ดู Selecting projects )
    • ผู้ติดตาม: ปล่อยช่องนี้ให้ว่าง หากคุณทราบว่าผู้ใช้งานที่เฉพาะเจาะจง จะให้ความสนใจในการแจ้งเตือนของทาสก์นี้ คุณสามารถเพิ่มได้ที่นี่ หรือเพียงละเว้นช่องนี้

ตรวจสอบว่ารายงานของคุณเสร็จสมบูรณ์ จากนั้นกดปุ่ม "Create Task" รายงานของคุณตอนนี้จะถูกบันทึกในฐานข้อมูล นี่ช่วยให้ผู้ที่สนใจในรายงานเข้าชมและอาจร่วมการแก้ไขด้วย

ระดับความสำคัญของมาสก์จะถูกตั้งค่าโดยผู้พัฒนาเมื่อจะเริ่มงาน (ดูที่ตั้งค่าระดับความสำคัญ)

และนั่นก็คือทั้งหมด! ขอบคุณที่ช่วยปรับปรุงมีเดียวิกิและโครงการวิกิมีเดีย!

รายงานข้อผิดพลาดของจาวาสคริปต์

ดูเพิ่ม: Help:Locating broken scripts

หลาย ๆ ฟังก์ชันเช่นแกดเจต สคริปต์ผู้ใช้ และบางส่วนของมีเดียวิกิ ขึ้นอยู่กับสิ่งที่เรียกว่าจาวาสคริปต์

เมื่อคุณพบข้อผิดพลาดที่อาจจะเกี่ยวข้องกับจาวาสคริปต์ วิธีที่ดีที่สุดคือ[$url ระบุข้อความผิดพลาด]และคัดลอกลงในรายงานข้อผิดพลาด

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

ถ้าปัญหาอยู่ในโค้ดของสคริปต์ผู้ใช้หรือแกดเจ็ตตัวเองตัวควบคุม ฟราบริเคเตอร์อาจไม่ใช่สถานที่ที่ปัญหาจะได้รับการจัดการ [1] อาจเปลี่ยนสถานที่เป็นหน้าพูดคุยของสคริปต์แทน (ถ้ามีการระบุสคริปต์ที่มีปัญหา)

รายงานปัญหาการเชื่อมต่อ

หากคุณประสบปัญหาในการเข้าถึงเว็บไซต์วิกิมีเดีย (เชื่อมต่ออินเทอร์เน็ตช้า ฯลฯ) โปรดปฏิบัติตาม https://wikitech-static.wikimedia.org/wiki/Reporting_a_connectivity_issue

รายงานปัญหาการเข้าสู่ระบบ

หากคุณประสบปัญหาในการเข้าสู่ระบบบัญชีของคุณโปรดปฏิบัติตาม Manual:How to debug/Login problems

หมายเหตุ

ดูเพิ่ม