Differences

This shows you the differences between two versions of the page.

--- bugs [2019/09/11 17:36] – [Reporting security bugs] hauke
+++ bugs [2022/06/16 13:53] (current) – add information regarding user interface issues lleachii
@@ Line 1: / Line 1: @@
-~~NOTOC~~
 ====== Reporting bugs ======
 ===== Bug or no bug? =====
-In case you are unsure if what you found is a bug, or if you have other issues that are not bugs, please use the forum, IRC or mailing list.
+In case you are unsure if what you found is a bug, or if you have other issues that are not bugs, please use the [[:contact#forum]], [[:contact#irc_channels|IRC]] or [[:contact#mailing_lists|mailing list]].
-===== Issue tracker =====
+===== Issue trackers =====
-Report bugs pertaining OpenWrt core functionality and device support using our [[https://bugs.openwrt.org/|issue tracker]].\\
+Report bugs pertaining OpenWrt functionality and device support using our issue trackers:
-If the bug is about a secondary package in the feeds you need to open an issue in the package feed's issue tracker instead.
+^ Issue tracker ^ Description ^
+| [[https://github.com/openwrt/openwrt/issues|github.com/openwrt/openwrt]] | Core |
+| [[https://github.com/openwrt/packages/issues|github.com/openwrt/packages]] | Packages |
+| [[https://github.com/openwrt/luci/issues|github.com/openwrt/luci]] | LuCI |
 If you are unsure, please use the [[packages:start|Packages tables]] to know where you should report the bug.
-When reporting bugs please make sure to:
+When reporting bugs, please be sure to specify:
   * Name the tree/revision/version
   * Name the affected device
@@ Line 19: / Line 21: @@
   * Any additional info you think is important
-Remember, the better is your bug report, the more likely it is that it will be worked on.
+Remember, the better is your bug report, the more likely it is that it will be worked on, [[https://www.chiark.greenend.org.uk/~sgtatham/bugs.html|How to Report Bugs Effectively]] is recommended reading.
 :!: Reporting a bug is important as it raises awareness of an issue, but it does not constitute a claim that anyone has to work on fixing it.
 ===== Reporting security bugs =====
 If you found a (potential) security problem and would like to report this confidential to the OpenWrt project please use [[contact@openwrt.org]].
-Not security related bug reports and support requests send to this email address will be ignored. Mails send to this address are received by most of the [[about#people|developers with commit access]].
+Non-security related bug reports and support requests send to this email address will be ignored. Mails send to this address are received by most of the [[about#people|developers with commit access]].
 We haven't set up a PGP key to send encrypted mail for this mail address yet.
-Please also inform us about CVEs you opened against OpenWrt under that e-mail address, preferable before the details are published, but please do so at last at the time of publishing.
+Please also inform us about CVEs you opened against OpenWrt using that e-mail address, preferably before the details are published, but please do so at latest at the time of publishing.
+===== Reporting user interface issues =====
+In the context of an ui issue, clear steps to reproduce would be:
+  * Describing the initial state (starting of a fresh config, sysupgraded from older version with retaining settings)
+  * Briefly mentioning the steps taken in which order, e.g.:
+  - What page browsed to
+  - What buttons pressed
+  - Any settings/options checked/typed/selected
+  - What button selected to save/apply
+  - **Clearly note error**