|
Filing a Good Bug Report
Pdf ko'rish
|
| bet | 80/174 | | Sana | 15.01.2024 | | Hajmi | 11,68 Mb. | | #137314 |
Bog'liq Kali-Linux-Revealed-2021-edition6.3. Filing a Good Bug Report
If all of your efforts to resolve a problem fail, it is possible that the problem is due to a bug in the
program. In this case, the problem may have resulted in a bug report. You can search for bug
reports to find a solution to your problem but let’s take a look at the procedure of reporting a bug
to Kali, Debian, or directly to the upstream developers so you understand the process should you
need to submit your own report.
The goal of a bug report is to provide enough information so that the developers or maintainers of
the (supposedly) faulty program can reproduce the problem, debug its behavior, and develop a fix.
This means that your bug report must contain appropriate information and must be directed to
the correct person or project team. The report must also be well-written and thorough, ensuring
a faster response.
The exact procedure for the bug report will vary depending on where you will submit the report
(Kali, Debian, or upstream developers) but there are some generic recommendations that apply
to all cases. In this chapter we will discuss those recommendations.
6.3.1. Generic Recommendations
Let’s discuss some general recommendations and guidelines that will help you submit a bug report
that is clear, comprehensive, and improves the chances that the bug will be addressed by the
developers in a timely fashion.
How to Communicate
Write Your Report in English The Free Software community is international and unless you
know your interlocutor, you should be using plain English. If you are a native speaker of English,
use simple sentences and avoid constructions that might be hard to understand for people with
limited English skills. Even though most developers are highly intelligent, not all of them have
strong English language skills. It is best never to assume.
Be Respectful of the Developers’ Work Remember that most Free Software developers (includ-
ing those behind Kali Linux) are benevolent and are spending their limited free time to work on
the software that you are freely using. Many are doing this out of altruism. Thus, when you file
a bug report, be respectful (even if the bug looks like an obvious mistake by the developer) and
don’t assume that they owe you a fix. Thank them for their contribution instead.
If you know how to modify and recompile the software, offer to assist the developers in testing
any patches that they submit to you. This will show them that you are willing to invest your own
time as well.
134
Kali Linux Revealed
|
| |
