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

shortcut: BUGREPORT
From mediawiki.org
This page is a translated version of the page How to report a bug and the translation is 97% 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

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

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

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

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

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

Is it a caching issue?

Some issues relate to older cached HTML being served alongside newer JavaScript where the two are incompatible. To help determine if this is the cause it is helpful to purge the page, refresh the page and see if the issue persists and include this information in your bug report.

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

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

  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

หมายเหตุ

ดูเพิ่ม