วิธีการรายงานข้อบกพร่อง
- 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
มีผู้อื่นรายงานปัญหาแล้วหรือไม่?
ใช้กล่องค้นหาของเครื่องมือติดตามข้อผิดพลาดวิกิมีเดียเพื่อดูว่าข้อผิดพลาดหรือคุณลักษณะใหม่ที่คุณพบหรือต้องการมีผู้รายงานแล้วหรือไม่ คุณสามารถทำการค้นหาแบบขั้นสูงได้เช่นกันที่หน้าค้นหาขั้นสูง
หากคุณไม่แน่ใจว่ามีการรายงานข้อผิดพลาดที่พบอยู่แล้วหรือไม่ คุณยังคงควรจะรายงานข้อบกพร่องนั้น เป็นการดีกว่าที่จะมีรายงานข้อผิดพลาดซ้ำกันแทนที่จะมีข้อผิดพลาดที่ยังไม่ได้รายงาน
อาจเป็นปัญหาเกี่ยวกับแกดเจตหรือสคริปต์ผูัใช้หรือไม่?
ปัญหาบางอย่างเป็นผลมาจากการใช้สคริปต์ผู้ใช้และแกดเจตที่มีข้อบกพร่องบางประการ มีแนวทาง และขั้นตอนในการระบุตำแหน่งของโค้ดที่ผอดพลาดซึ่งอาจแก้ปัญหาของคุณได้โดยไม่จำเป็นต้องเสียเวลารายงานข้อผิดพลาด
รายงานข้อผิดพลาดหรือขอคุณลักษณะใหม่
หากคุณพบกับข้อผิดพลาดในรุ่นมีเดียวิกิในอดีต และดูเหมือนจะยังไม่มีใครมีการรายงาน กรุณา:
- ไปที่ phabricator.wikimedia.org
- คุณจะถูกขอให้เข้าสู่ระบบ (หรือลงทะเบียน) หากยังมีไม่ได้เข้าสู่ระบบ (ดู "สร้างบัญชีของคุณ ")
- กดที่ปุ่มบุ๊คมาร์คบริเวณมุมขวาบนและเลือก "Create Task" (หรือ "Report Security issues" สำหรับการรายงานเกี่ยวกับปัญหาด้านความปลอดภัย )
- ให้ข้อมูลต่อไปนี้เป็นอย่างน้อย:
- ชื่อ: สรุปสั้น ๆ หนึ่งประโยคที่อธิบายถึงปัญหาที่เกิดขึ้น (ไม่ใช่อธิบายวิธีการแก้ปัญหาของคุณ)
- ตัวอย่างที่ดี:
"Selecting gender is not functional on Special:Preferences"
- ตัวอย่างที่แย่:
"Software crashes"
- ตัวอย่างที่ดี:
- คำอธิบาย: รายละเอียดแบบเต็มของปัญหา ให้สารสนเทศที่ละเอียดมากที่สุดเท่าที่เป็นไปได้ทั้งหมดที่คุณมี หากไม่เพียงพอ คุณจะถูกถามข้อมูลเพิ่มเติมพร้อมกับคำแนะนำเกี่ยวกับวิธีการขอรับข้อมูลดังกล่าว ซึ่งควรประกอบไปด้วย:
- สำหรับข้อผิดพลาด:
- ขั้นตอนในการแสดงข้อผิดพลาดซ้ำ ขั้นตอนที่สามารถปฏิบัติตามได้ซึ่งทำให้เกิดปัญหาที่ระบุ รวมถึงขั้นตอนพิเศษใด ๆ
- ตัวอย่าง:
Go to https://en.wikipedia.org with Internet Explorer version 10.0;
Make sure you are logged in;
Select "My Preferences" menu;
Go to "Gender" and select female gender from box list;
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"
- ตัวอย่าง:
- รายละเอียดของสิ่งที่คุณต้องการพร้อมเหตุผล ขยายความว่าคุณหวังอะไรจาการได้รับคุณลักษณะ (ปัญหาพื้นฐานจริง ๆ) พร้อมกับระบุตัวอย่าง แต่่่่่กรุณาอย่าให้วิธีการแก้ปัญหา เนื่องจากอาจมีการแก้ปัญหาแบบอื่นที่ดีกว่าที่คุณเสนอและเราจะจมกับการแก้ปัญหาของคุณ User story เป็นวิธีที่ชาญฉลาดที่จะดูสิ่งนี้
- โปรดให้ข้อมูลอื่น ๆ ที่อาจจะมีประโยชน์ เช่น:
- เว็บเบราเซอร์ สกิน หรือระบบคอมพิวเตอร์ที่คุณพบข้อผิดพลาด
- ลิงก์หรือความแตกต่างตั้งแต่หนึ่งหน้าหรือมากกว่าที่คุณพบข้อผิดพลาด หรือ
- หรือว่าปัญหาจะเกิดอยู่ตลอด? แค่บางครั้ง? เฉพาะบางหน้า? หรือเกิดแต่ในสถานการณ์เฉพาะ?
- สำหรับข้อผิดพลาด:
- การแนบไฟล์ 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
หมายเหตุ
ดูเพิ่ม
- วิธีการรายงานข้อบกพร่องอย่างมีประสิทธิภาพ โดยไซมอน เทธัม
- How to get the developer community to solve your problem โดย User:MSchottlender-WMF กรกฏาคม 2017
- วิกิมีเดีย Phabricator
- การจัดการข้อผิดพลาด/วงจรการรายงานข้อผิดพลาด
- การเขียนรายงานข้อผิดพลาดที่ดีหรือการร้องขอคุณสมบัติ
- วิธีการสร้างรายงานข้อผิดพลาดแรกของคุณให้ดีที่สุด (ล้าสมัย)
- วิกิพีเดีย:รายงานข้อผิดพลาดและขอคุณสมบัติ