aboutsummaryrefslogtreecommitdiffstats
diff options
context:
space:
mode:
authorSarah Sharp2013-04-13 21:30:48 -0500
committerSarah Sharp2013-04-18 18:54:53 -0500
commitbc6bed481ff3fbe2050f4290f59d27fad30b62a7 (patch)
tree26419cbcc1508a8bc04f42d9096b967c2ca1bc65 /REPORTING-BUGS
parent2c97a63f6fec91db91241981808d099ec60a4688 (diff)
downloadkernel-omap-bc6bed481ff3fbe2050f4290f59d27fad30b62a7.tar.gz
kernel-omap-bc6bed481ff3fbe2050f4290f59d27fad30b62a7.tar.xz
kernel-omap-bc6bed481ff3fbe2050f4290f59d27fad30b62a7.zip
Docs: Expectations for bug reporters and maintainers
Outline how often it's polite to ping kernel maintainers about bugs, and suggest that kernel maintainers should respond to bugs in 1 to 5 business days. Emphasize that regressions, userspace breakage, and kernel crashes are exceptions to that rule. Suggest escalation to LKML and Linus if these bugs are ignored during the merge window. Signed-off-by: Sarah Sharp <sarah.a.sharp@linux.intel.com> Acked-by: Linus Torvalds <torvalds@linux-foundation.org>
Diffstat (limited to 'REPORTING-BUGS')
-rw-r--r--REPORTING-BUGS42
1 files changed, 41 insertions, 1 deletions
diff --git a/REPORTING-BUGS b/REPORTING-BUGS
index c1f6e43f06f3..327b33b43d63 100644
--- a/REPORTING-BUGS
+++ b/REPORTING-BUGS
@@ -117,4 +117,44 @@ summary from [1.]>" for easy identification by the developers.
117[X.] Other notes, patches, fixes, workarounds: 117[X.] Other notes, patches, fixes, workarounds:
118 118
119 119
120Thank you 120Follow up
121=========
122
123Expectations for bug reporters
124------------------------------
125
126Linux kernel maintainers expect bug reporters to be able to follow up on
127bug reports. That may include running new tests, applying patches,
128recompiling your kernel, and/or re-triggering your bug. The most
129frustrating thing for maintainers is for someone to report a bug, and then
130never follow up on a request to try out a fix.
131
132That said, it's still useful for a kernel maintainer to know a bug exists
133on a supported kernel, even if you can't follow up with retests. Follow
134up reports, such as replying to the email thread with "I tried the latest
135kernel and I can't reproduce my bug anymore" are also helpful, because
136maintainers have to assume silence means things are still broken.
137
138Expectations for kernel maintainers
139-----------------------------------
140
141Linux kernel maintainers are busy, overworked human beings. Some times
142they may not be able to address your bug in a day, a week, or two weeks.
143If they don't answer your email, they may be on vacation, or at a Linux
144conference. Check the conference schedule at LWN.net for more info:
145 https://lwn.net/Calendar/
146
147In general, kernel maintainers take 1 to 5 business days to respond to
148bugs. The majority of kernel maintainers are employed to work on the
149kernel, and they may not work on the weekends. Maintainers are scattered
150around the world, and they may not work in your time zone. Unless you
151have a high priority bug, please wait at least a week after the first bug
152report before sending the maintainer a reminder email.
153
154The exceptions to this rule are regressions, kernel crashes, security holes,
155or userspace breakage caused by new kernel behavior. Those bugs should be
156addressed by the maintainers ASAP. If you suspect a maintainer is not
157responding to these types of bugs in a timely manner (especially during a
158merge window), escalate the bug to LKML and Linus Torvalds.
159
160Thank you!