Bug report template: Difference between revisions
Jump to navigation
Jump to search
m (→軟硬體環境資訊) Tags: Mobile edit Mobile web edit |
|||
(16 intermediate revisions by the same user not shown) | |||
Line 1: | Line 1: | ||
網站或軟體功能問題回報範本 | 網站或軟體功能問題回報範本 | ||
== 客戶填寫的表單 == | == 客戶填寫的表單 (Takeaway) == | ||
* 問題描述 (Bug description) | |||
* 預期看到的結果 (Expected behavior) | |||
* 出現問題的操作步驟 (Steps to reproduce) | |||
* 遇到的問題狀況 (Actual behavior) | |||
* 軟硬體環境資訊 | |||
* 填寫者: 方便聯繫 | |||
== 客戶填寫的表單 詳細說明 == | |||
=== 問題描述 (Bug description) === | === 問題描述 (Bug description) === | ||
說明 | 說明 | ||
* 當時你想要做什麼? | * 當時你想要做什麼? | ||
* 問題摘要描述 | * 問題摘要描述 | ||
=== 預期看到的結果 (Expected behavior) === | |||
說明: | |||
* 描述你預期看到怎樣的結果。 | |||
* 提供開發者知道:你希望功能可以達到什麼目標、或畫面效果有怎樣的變化,可以讓開發者瞭解現有功能跟使用者的預期出現認知落差。 | |||
=== 出現問題的操作步驟 (Steps to reproduce) === | === 出現問題的操作步驟 (Steps to reproduce) === | ||
Line 11: | Line 25: | ||
* 可以重複出現相同問題的操作步驟。如果無法重複出現相同問題,問題原因可能不是出在網站或軟體功能,而是外部因素,例如伺服器、網站連線速度等。 | * 可以重複出現相同問題的操作步驟。如果無法重複出現相同問題,問題原因可能不是出在網站或軟體功能,而是外部因素,例如伺服器、網站連線速度等。 | ||
* 不需要假設任何原因,盡可能詳細描述操作細節。如果是軟體功能,可以紀錄最近電腦環境是否有變化。 | * 不需要假設任何原因,盡可能詳細描述操作細節。如果是軟體功能,可以紀錄最近電腦環境是否有變化。 | ||
* 遇到問題時不要馬上就回報給工程團隊,可以試看看不同操作步驟或環境,會不會遇到相同問題,可以增加工程師對問題的了解。 (謝謝 Amos!) | * 遇到問題時不要馬上就回報給工程團隊,可以試看看不同操作步驟或環境,會不會遇到相同問題,可以增加工程師對問題的了解。 (謝謝 [http://csscoke.com/ Amos] 分享!) | ||
=== 遇到的問題狀況 (Actual behavior) === | === 遇到的問題狀況 (Actual behavior) === | ||
說明: | 說明: | ||
* 遇到什麼狀況 | * 遇到什麼狀況 | ||
* 如果有畫面或訊息文字的話,可以使用 [[Screen Capture | 螢幕畫面擷取]] | * 如果有畫面或訊息文字的話,可以使用 [[Screen Capture | 螢幕畫面擷取]] 工具,擷取電腦或 APP 的畫面和錯誤訊息文字 | ||
* 嘗試過哪些方法解決這個問題、發現怎樣的替代過渡辦法 (Workaround) | * 嘗試過哪些方法解決這個問題、發現怎樣的替代過渡辦法 (Workaround) 可以解決這個問題 | ||
=== 軟硬體環境資訊 === | === 軟硬體環境資訊 === | ||
軟硬體環境資訊。除了請使用者擷取螢幕畫面、網站可透過 [[User agent]] 偵測使用者部分的電腦環境、瀏覽器版本資訊。 | |||
# 個人電腦作業系統 (桌面 --> 「我的電腦」圖示 --> 按右鍵選「內容」) | # 個人電腦作業系統 (桌面 --> 「我的電腦」圖示 --> 按右鍵選「內容」) | ||
# 個人電腦的硬體規格 (CPU, 硬碟)、硬體型號 | # 個人電腦的硬體規格 (CPU, 硬碟)、硬體型號 | ||
# 使用的軟體名稱 及 軟體版本 (通常在軟體上方選單列的說明 --> 關於該軟體)、 | # 使用的軟體名稱 及 軟體版本 (通常在軟體上方選單列的說明 --> 關於該軟體)、 | ||
# 瀏覽器名稱 及 瀏覽器版本。除了常見的瀏覽器,部份 APP 也可瀏覽網頁,例如: Facebook。 | # 瀏覽器: (1) 瀏覽器名稱 及 瀏覽器版本。除了常見的瀏覽器,部份 APP 也可瀏覽網頁,例如: Facebook。 (2) 瀏覽器擴充套件<ref>「當我要下載這張憑證的元件時,它的頁面被 Privacy Badger 給擋掉了。」[https://medium.com/@yinchuchen/egov-tax-service-in-taiwan-2e90d143a600 新版報稅介面的挫折經驗 – YingChu Chen – Medium]</ref> (3) 信任的網站等設定。 | ||
# 防毒軟體 | # 防毒軟體 | ||
# 防火牆 | # 防火牆 | ||
Line 39: | Line 48: | ||
== 內部團隊填寫的表單 == | == 內部團隊填寫的表單 == | ||
增加「嚴重程度」項目 | |||
=== 嚴重程度 (Severity level) === | === 嚴重程度 (Severity level) === | ||
Line 50: | Line 61: | ||
* 答: 個人意見是可以回報,但是不要期待是由開發者修復。因為問題可能不是程式功能,而出現在伺服器架構或者是網路速度等其他因素,需要不同角色參與解決。 | * 答: 個人意見是可以回報,但是不要期待是由開發者修復。因為問題可能不是程式功能,而出現在伺服器架構或者是網路速度等其他因素,需要不同角色參與解決。 | ||
== 參考資料 == | == 參考資料 == | ||
<References /> | |||
Message template - ''I have a bug to report'': source: [https://www.rememberthemilk.com/ Remember The Milk] {{access | date = 2015-03-02}} | Message template - ''I have a bug to report'': source: [https://www.rememberthemilk.com/ Remember The Milk] {{access | date = 2015-03-02}} | ||
<pre> | <pre> | ||
Line 67: | Line 76: | ||
</pre> | </pre> | ||
* [https://github.com/docker/kitematic/issues/new New Issue · docker/kitematic] | * [https://github.com/docker/kitematic/issues/new New Issue · docker/kitematic] | ||
* 相關頁面: [[PC SOS]] | * [https://stackoverflow.com/help/mcve How to create a Minimal, Complete, and Verifiable example - Help Center - Stack Overflow] | ||
* [https://gitlab.com/help/user/project/description_templates Description templates · GitLab] {{access | date = 2017-10-25}} | |||
* [https://www.riohondo.edu/its/helpdesk/writing-a-good-helpdesk-ticket/ Writing a Good Helpdesk Ticket | Information Technology Services] {{access | date = 2019-05-21}} | |||
* [https://phabricator.wikimedia.org/ Wikimedia Phabricator] | |||
* 相關頁面: [[PC SOS]]、[[RequestTracker]], Issue Tracker | |||
* unit test & integration test | |||
{{Template:Troubleshooting}} | {{Template:Troubleshooting}} | ||
[[Category:Templates]] [[Category:Programming]] [[Category:Software]] | [[Category:Templates]] [[Category:Programming]] [[Category:Software]] |
Latest revision as of 09:03, 10 May 2022
網站或軟體功能問題回報範本
客戶填寫的表單 (Takeaway)[edit]
- 問題描述 (Bug description)
- 預期看到的結果 (Expected behavior)
- 出現問題的操作步驟 (Steps to reproduce)
- 遇到的問題狀況 (Actual behavior)
- 軟硬體環境資訊
- 填寫者: 方便聯繫
客戶填寫的表單 詳細說明[edit]
問題描述 (Bug description)[edit]
說明
- 當時你想要做什麼?
- 問題摘要描述
預期看到的結果 (Expected behavior)[edit]
說明:
- 描述你預期看到怎樣的結果。
- 提供開發者知道:你希望功能可以達到什麼目標、或畫面效果有怎樣的變化,可以讓開發者瞭解現有功能跟使用者的預期出現認知落差。
出現問題的操作步驟 (Steps to reproduce)[edit]
說明:
- 可以重複出現相同問題的操作步驟。如果無法重複出現相同問題,問題原因可能不是出在網站或軟體功能,而是外部因素,例如伺服器、網站連線速度等。
- 不需要假設任何原因,盡可能詳細描述操作細節。如果是軟體功能,可以紀錄最近電腦環境是否有變化。
- 遇到問題時不要馬上就回報給工程團隊,可以試看看不同操作步驟或環境,會不會遇到相同問題,可以增加工程師對問題的了解。 (謝謝 Amos 分享!)
遇到的問題狀況 (Actual behavior)[edit]
說明:
- 遇到什麼狀況
- 如果有畫面或訊息文字的話,可以使用 螢幕畫面擷取 工具,擷取電腦或 APP 的畫面和錯誤訊息文字
- 嘗試過哪些方法解決這個問題、發現怎樣的替代過渡辦法 (Workaround) 可以解決這個問題
軟硬體環境資訊[edit]
軟硬體環境資訊。除了請使用者擷取螢幕畫面、網站可透過 User agent 偵測使用者部分的電腦環境、瀏覽器版本資訊。
- 個人電腦作業系統 (桌面 --> 「我的電腦」圖示 --> 按右鍵選「內容」)
- 個人電腦的硬體規格 (CPU, 硬碟)、硬體型號
- 使用的軟體名稱 及 軟體版本 (通常在軟體上方選單列的說明 --> 關於該軟體)、
- 瀏覽器: (1) 瀏覽器名稱 及 瀏覽器版本。除了常見的瀏覽器,部份 APP 也可瀏覽網頁,例如: Facebook。 (2) 瀏覽器擴充套件[1] (3) 信任的網站等設定。
- 防毒軟體
- 防火牆
- 網路頻寬 ex: HiNet連線速率測試 - HiNet測速網站
- 相關連結網址
填寫者[edit]
方便聯繫
內部團隊填寫的表單[edit]
增加「嚴重程度」項目
嚴重程度 (Severity level)[edit]
- 4種: 不重要的(Trivial), 小(Minor), 大(Major), 及災難(Catastrophic)
- 4種: 小(Minor), 一般(Normal), 大(Major), 嚴重(Critical) via Priority levels of issues | Drupal.org
- 5種: 不重要的(Trivial), 小(Minor), 大(Major), 嚴重(Critical)、及 Blocker via Bitbucket
- 5種: 可忽略(Insignificant)、小(Minor)、中等(moderate)、大(Major)及災難(Catastrophic)
問題討論[edit]
問: 無法提供「可以重複出現相同問題的操作步驟」,要不要回報?
- 答: 個人意見是可以回報,但是不要期待是由開發者修復。因為問題可能不是程式功能,而出現在伺服器架構或者是網路速度等其他因素,需要不同角色參與解決。
參考資料[edit]
- ↑ 「當我要下載這張憑證的元件時,它的頁面被 Privacy Badger 給擋掉了。」新版報稅介面的挫折經驗 – YingChu Chen – Medium
Message template - I have a bug to report: source: Remember The Milk [Last visited: 2015-03-02]
1. What steps will reproduce the problem? 2. What is the expected result? What do you see instead? 3. Anything else you think we should know?
- New Issue · docker/kitematic
- How to create a Minimal, Complete, and Verifiable example - Help Center - Stack Overflow
- Description templates · GitLab [Last visited: 2017-10-25]
- Writing a Good Helpdesk Ticket | Information Technology Services [Last visited: 2019-05-21]
- Wikimedia Phabricator
- 相關頁面: PC SOS、RequestTracker, Issue Tracker
- unit test & integration test
Troubleshooting of ...
- PHP, cUrl, Python, selenium, HTTP status code errors
- Database: SQL syntax debug, MySQL errors, MySQLTuner errors or PostgreSQL errors
- HTML/Javascript: Troubleshooting of javascript, XPath
- Software: Mediawiki, Docker, FTP problems, online conference software
- Test connectivity for the web service, Web Ping, Network problem, Web user behavior, Web scrape troubleshooting
Template